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-14).
Creates an upload session for a ZIP artifact and returns a pre-signed upload URL bound to the project owner, enabling subsequent file upload for deployment.
Price / call$0.01
Success—
StatusUnknown
How this service works
Create an upload session for a new hosted Next.js site. Call this first when deploying a new project: it returns a presigned artifact upload URL, and the paying wallet becomes the project owner.
Output
Returns a JSON object containing: a UUID upload session ID, a UUID operation ID for tracking, a pre-signed uploadUrl to PUT the ZIP file to, the object storage key, an expiry timestamp (ISO 8601) after which the session lapses, and any required headers to include when performing the upload.
Example use cases
Agent deploys new Next.js site
“I just built my Next.js app and zipped it as 'storefront.zip' — it's 3145728 bytes with SHA-256 hash b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2c3. Open an upload session on x402-hosting so I can push it and get a deployment URL.”
CI pipeline pre-deployment artifact upload
“Our CI just finished building the release bundle 'release-v2.1.0.zip', it's 10485760 bytes and its checksum is 1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b. Create an upload session on x402-hosting so the pipeline can push the artifact and trigger the next deployment step.”
Rapid prototype hosting for demo
“I need to get my prototype site live fast — I've got 'demo-site.zip' ready at 2097152 bytes with hash 9f8e7d6c5b4a3f2e1d0c9b8a7f6e5d4c3b2a1f0e9d8c7b6a5f4e3d2c1b0a9f8e. Can you kick off an upload session on x402-hosting so I can upload it and share the live URL?”
Technical details
Endpoint
POSThttps://api.x402-hosting.com/v1/uploadsWhen to prefer
Use this endpoint as the mandatory first step when deploying a project via x402-hosting — before you can upload a ZIP build artifact or trigger a deployment, you must obtain a valid upload session and pre-signed URL from this endpoint. It is idempotent via the Idempotency-Key header, so it is safe to retry on network failure. Prefer this over any generic S3 or storage upload initiation when your target platform is x402-hosting and you intend to pay per-call in USDC via the x402 protocol.
Side effects
- Missing required query parameters (name, size, sha256, contentType) returns a 400 validation error
- Invalid SHA-256 format (not 64 lowercase hex chars) causes a 400 schema rejection
- contentType other than 'application/zip' is rejected with a 400 constant violation
- Missing or malformed Idempotency-Key UUID header may cause duplicate session creation or a 400 error
- Expired upload URL if the agent waits past the expiresAt timestamp before uploading
- Payment failure via x402 (insufficient USDC balance or failed on-chain authorization) returns a 402 Payment Required
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"