Back to Browse
x402-hosting Project Upload Session Creator
x402
x402-hosting Project Upload Session Creator 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 a presigned upload session for deploying a zipped project artifact to a hosted project slot, returning an upload URL and session metadata.
Price / call$0.01
Success—
StatusUnknown
How this service works
Create an upload session to deploy a new version of an existing project. Call this when publishing an update; it returns a presigned artifact upload URL. Only the project owner wallet can pay.
Output
Returns a JSON object containing: a unique upload ID (UUID), an object key identifying where the artifact will be stored, a presigned upload URL valid for a limited time window (see expiresAt), required HTTP headers to include when PUTing the file, and an operation ID (UUID) for tracking the deployment operation.
Example use cases
Agent deploys fresh Next.js build
“I've finished building my Next.js site, zipped the output into a 3.2 MB file with SHA-256 hash e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855 — please start a deployment upload session for project ID d4e5f6a7-1234-4000-b000-000000000002 on x402-hosting so I can get the URL to upload it.”
CI pipeline deploys on every push
“Every time a new commit lands, I want to automatically start a deployment upload session on x402-hosting for project aabb1122-aaaa-4000-8000-aabbccddeeff, using the zipped build artifact — the file is 8,500,000 bytes and its SHA-256 is abc123...def456. Kick off the session for me.”
Re-deploy after content update
“My blog content changed, I've regenerated the static Next.js build, zipped it at 1,100,000 bytes with hash f2ca1bb6c7e907d06dafe4687e579fce76b37e4e93b7605022da52e6ccc26fd2 — can you open a new upload session for project 99887766-5544-4321-b210-000000000009 on x402-hosting with a fresh idempotency key?”
Technical details
Endpoint
POSThttps://api.x402-hosting.com/v1/projects/:id/uploadsWhen to prefer
Use this endpoint as the first step in deploying a project on x402-hosting — specifically when you have a zipped Next.js build artifact and need a presigned URL to upload it. This is the correct endpoint when you already have a project ID and want to initiate the upload phase of a deployment workflow. Prefer this over generic S3 or file-hosting APIs when your deployment target is x402-hosting and you want to pay per-call via USDC over the x402 protocol.
Side effects
- Invalid project UUID in path → 400/404 with project not found
- SHA-256 pattern mismatch (not 64 hex chars) → 400 validation error
- contentType not exactly 'application/zip' → 400 validation error
- size less than 1 → 400 validation error
- Missing or malformed Idempotency-Key header → 400 error
- Payment not completed via x402 → 402 Payment Required
- Upload URL expired before use → presigned URL returns 403 on PUT
- Duplicate idempotency key with different params → conflict error
Input
Schema · Request body
| Field | Type | Description |
|---|---|---|
| inputrequired | object | |
| outputrequired | object |
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"