{"uid":"cap_vtV0qBddkuJXz0NmdQRe3","slug":"stableupload-ee499b31","name":"StableUpload Site Upload Slot Purchase","description":"Buy a site upload slot. Upload a zip file, then activate to extract and serve as a static site.","url":"https://stableupload.dev/api/site?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"tier":{"enum":["10mb","100mb","1gb","short-10mb","short-100mb","short-1gb"],"type":"string","description":"Site tier. Default 6-month tiers: 10mb ($0.02), 100mb ($0.20), 1gb ($2.00). Short-term 7-day workflow site tiers: short-10mb ($0.005), short-100mb ($0.02), short-1gb ($0.10). short-5gb is not supported for sites."},"filename":{"type":"string","maxLength":512,"minLength":1,"description":"Name of the zip file to upload"},"policyTtlSeconds":{"type":"integer","maximum":86400,"minimum":60,"description":"Optional upload URL/form expiration in seconds, 60-86400. Use longer TTLs only when reserving an output slot for a downstream service."}}},"responseSchema":{"type":"json","example":{"maxSize":10485760,"postUrl":"https://stableupload-prod.s3.us-east-1.amazonaws.com/","uploadId":"bs94s5b4ca","expiresAt":"2026-05-02T16:00:00.000Z","uploadUrl":"https://stableupload-prod.s3.us-east-1.amazonaws.com/","postFields":{"key":"uploads/bs94s5b4ca/site.zip","policy":"base64-policy","x-amz-date":"20260425T160000Z","Content-Type":"application/zip","x-amz-algorithm":"AWS4-HMAC-SHA256","x-amz-signature":"hex-signature","x-amz-credential":"AKIAEXAMPLE/20260425/us-east-1/s3/aws4_request"},"curlExample":"curl -X POST \"https://stableupload-prod.s3.us-east-1.amazonaws.com/\" -F \"key=uploads/bs94s5b4ca/site.zip\" -F \"Content-Type=application/zip\" -F \"x-amz-algorithm=AWS4-HMAC-SHA256\" -F \"x-amz-credential=AKIAEXAMPLE/20260425/us-east-1/s3/aws4_request\" -F \"x-amz-date=20260425T160000Z\" -F \"policy=base64-policy\" -F \"x-amz-signature=hex-signature\" -F \"file=@site.zip;type=application/zip\"","uploadMethod":"post","uploadUrlExpiresAt":"2026-04-25T16:15:00.000Z"}},"example":{"request":{"tier":"short-10mb","filename":"mysite.zip","policyTtlSeconds":3600},"response":{"maxSize":10485760,"postUrl":"https://x402-upload-prod.s3.us-east-1.amazonaws.com/","uploadId":"yc5wtg8mtj","expiresAt":"2026-06-12T04:30:23.202Z","uploadUrl":"https://x402-upload-prod.s3.us-east-1.amazonaws.com/","postFields":{"key":"uploads/yc5wtg8mtj/mysite.zip","policy":"eyJleHBpcmF0aW9uIjoiMjAyNi0wNi0wNVQwNTozMDoyMy45NDhaIiwiY29uZGl0aW9ucyI6W3siYnVja2V0IjoieDQwMi11cGxvYWQtcHJvZCJ9LHsia2V5IjoidXBsb2Fkcy95YzV3dGc4bXRqL215c2l0ZS56aXAifSx7IkNvbnRlbnQtVHlwZSI6ImFwcGxpY2F0aW9uL3ppcCJ9LHsieC1hbXotYWxnb3JpdGhtIjoiQVdTNC1ITUFDLVNIQTI1NiJ9LHsieC1hbXotY3JlZGVudGlhbCI6IkFLSUEyQVVPTzdCUkREUVBXREVWLzIwMjYwNjA1L3VzLWVhc3QtMS9zMy9hd3M0X3JlcXVlc3QifSx7IngtYW16LWRhdGUiOiIyMDI2MDYwNVQwNDMwMjNaIn0sWyJjb250ZW50LWxlbmd0aC1yYW5nZSIsMCwxMDQ4NTc2MF1dfQ==","x-amz-date":"20260605T043023Z","Content-Type":"application/zip","x-amz-algorithm":"AWS4-HMAC-SHA256","x-amz-signature":"43d6717c77066957af9980a76f03232608705119649385d170906852a78ae7a5","x-amz-credential":"AKIA2AUOO7BRDDQPWDEV/20260605/us-east-1/s3/aws4_request"},"curlExample":"curl -X POST \"https://x402-upload-prod.s3.us-east-1.amazonaws.com/\" -F 'key=uploads/yc5wtg8mtj/mysite.zip' -F 'Content-Type=application/zip' -F 'x-amz-algorithm=AWS4-HMAC-SHA256' -F 'x-amz-credential=AKIA2AUOO7BRDDQPWDEV/20260605/us-east-1/s3/aws4_request' -F 'x-amz-date=20260605T043023Z' -F 'policy=eyJleHBpcmF0aW9uIjoiMjAyNi0wNi0wNVQwNTozMDoyMy45NDhaIiwiY29uZGl0aW9ucyI6W3siYnVja2V0IjoieDQwMi11cGxvYWQtcHJvZCJ9LHsia2V5IjoidXBsb2Fkcy95YzV3dGc4bXRqL215c2l0ZS56aXAifSx7IkNvbnRlbnQtVHlwZSI6ImFwcGxpY2F0aW9uL3ppcCJ9LHsieC1hbXotYWxnb3JpdGhtIjoiQVdTNC1ITUFDLVNIQTI1NiJ9LHsieC1hbXotY3JlZGVudGlhbCI6IkFLSUEyQVVPTzdCUkREUVBXREVWLzIwMjYwNjA1L3VzLWVhc3QtMS9zMy9hd3M0X3JlcXVlc3QifSx7IngtYW16LWRhdGUiOiIyMDI2MDYwNVQwNDMwMjNaIn0sWyJjb250ZW50LWxlbmd0aC1yYW5nZSIsMCwxMDQ4NTc2MF1dfQ==' -F 'x-amz-signature=43d6717c77066957af9980a76f03232608705119649385d170906852a78ae7a5' -F 'file=@mysite.zip;type=application/zip'","uploadMethod":"post","uploadUrlExpiresAt":"2026-06-05T05:30:23.948Z"}},"exampleRequest":{"tier":"short-10mb","filename":"mysite.zip","policyTtlSeconds":3600},"tags":["x402"],"displayCostAmount":"2","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":2,"rating":{"score":"1.00","successRate":"0.68","reviews":2,"stars":"5.0","state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$2/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"2","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"2","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_YqG9xApv50QJTzhqXLRYO","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"2","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Purchases a site upload slot, returning a URL to upload a zip file that can then be activated as a static site.","exampleAgentPrompt":"Buy me a StableUpload site slot so I can publish my static site — I have a zip file of my HTML/CSS/JS build ready to upload and then activate.","exampleUseCases":null,"resultDescription":"Returns an upload slot with a pre-signed upload URL for posting the zip file, along with an upload ID and site ID needed to subsequently activate the site and make it live.","failureModes":["Insufficient USDC balance or payment failure — payment rejected, slot not created","Invalid or missing wallet authentication — 401 unauthorized","Payment protocol (x402) not supported by client — request fails before slot creation","Rate limiting or quota exceeded — 429 too many requests","Server error during slot creation — 500 internal server error"],"whenToPreferThis":"Use this endpoint when you need to deploy a static website from a zip archive via a pay-per-use micropayment model (x402/USDC). Prefer this over traditional hosting APIs when operating as an autonomous agent needing programmatic, wallet-authenticated site deployment without a subscription or account setup. This is the first step in a two-step flow: buy slot here, then upload the zip, then call the Activate endpoint.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T06:39:32.549Z","isFirstParty":false,"canonicalSlug":"stableupload-ee499b31"}