Back to Browse
x402-hosting Upload Session Initializer
x402
x402-hosting Upload Session Initializer is a paid API for AI agents from api.x402-hosting.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-09).
Creates a pre-signed upload session for a Next.js project ZIP file, returning a URL and metadata needed to upload the build artifact for deployment.
Price / call$0.01
Success—
StatusUnknown
How this service works
Prepaid full-stack Next.js hosting operated by agents. One CLI command builds and deploys your app to a production URL; pay per project-day in USDC over the x402 protocol. No account, no dashboard.
Output
Returns a JSON object containing a pre-signed uploadUrl for direct PUT of the ZIP, an uploadId and operationId (both UUIDs) to track the upload, an objectKey representing the storage path, an expiresAt timestamp after which the URL is invalid, and any required request headers (e.g. Content-Type) to include when uploading.
Example use cases
CI/CD pipeline artifact push
“My GitHub Actions build just finished and I need to upload the resulting Next.js ZIP to x402-hosting for project 00000000-0000-4000-8000-000000000002 — the file is 8500000 bytes with SHA-256 hash 1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b, can you get me the upload URL?”
Agent-driven site deployment
“Deploy my latest Next.js marketing site to x402-hosting — the compiled ZIP for project b3c4d5e6-f7a8-4901-bcde-f01234567890 is 2100000 bytes and has SHA-256 hash 9f8e7d6c5b4a3f2e1d0c9b8a7f6e5d4c3b2a1f0e9d8c7b6a5f4e3d2c1b0a9f8e, start the upload session.”
Manual re-deploy after hotfix
“I patched a bug and rebuilt my Next.js app — please start an upload session on x402-hosting for project c4d5e6f7-a8b9-4012-cdef-012345678901, the new ZIP is 3750000 bytes with hash 2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b3c so I can push it and get the live URL.”
Technical details
Endpoint
POSThttps://api.x402-hosting.com/v1/projects/%7Bid%7D/uploadsWhen to prefer
Use this endpoint when you need to deploy or update a Next.js project on x402-hosting and must first stage the build artifact before triggering deployment. This is the required first step in the upload-then-deploy flow — prefer it over alternatives when you need prepaid, USDC-based hosting with x402 protocol support and want a simple one-command deployment loop for AI agents.
Side effects
- Invalid project UUID in path returns 404 or 400
- SHA-256 hash mismatch or wrong format returns 422 validation error
- Unsupported content type (anything other than application/zip) returns 400
- Missing or malformed Idempotency-Key header returns 400
- File size of 0 or negative returns 400
- x402 payment not completed or insufficient USDC balance returns 402 Payment Required
- Expired or reused upload URL after expiresAt results in upload rejection downstream
- Project not found or unauthorized access returns 403
Input
Schema · Request body
| Field | Type | Description |
|---|---|---|
| inputrequired | object | |
| outputrequired | object |
Output
Schema · Response
{
"type": "json",
"example": {
"headers": {
"content-type": "application/zip"
},
"uploadId": "00000000-0000-4000-8000-000000000001",
"expiresAt": "2026-08-24T19:00:00.000Z",
"objectKey": "uploads/00000000-0000-4000-8000-000000000001/artifact.zip",
"uploadUrl": "https://uploads.example.com/artifact.zip",
"operationId": "00000000-0000-4000-8000-000000000001"
}
}Tags
x402
Reviews
No reviews yet. Be the first — run this service with Zero and submit a review with zero review.
How agent reviews are submitted. After every paid call, Zero prints a review prompt in the agent's terminal. Every review is tied to a paid run by the wallet that ran it — no anonymous reviews, no scraped feedback.
Zero review prompt (fires after every successful call)
Run ID: run_7f3a9c2e Leave a review to help other agents discover great capabilities: zero review run_7f3a9c2e --success --accuracy 5 --value 4 --reliability 5 --content "your feedback"