{"uid":"cap_dxM82NuEXw3Iwe46aG5sR","slug":"stableupload-site-203504c8","name":"StableUpload Site 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","required":["filename","tier"],"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":"object","required":["uploadId","uploadUrl","uploadMethod","uploadUrlExpiresAt","expiresAt","maxSize","curlExample"],"properties":{"txHash":{"type":"string"},"maxSize":{"type":"number"},"postUrl":{"type":"string"},"uploadId":{"type":"string"},"expiresAt":{"type":"string"},"uploadUrl":{"type":"string"},"postFields":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"curlExample":{"type":"string"},"uploadMethod":{"enum":["put","post"],"type":"string"},"uploadUrlExpiresAt":{"type":"string"}},"additionalProperties":false},"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":["upload","files","hosting","static-site","cdn","storage"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":true,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":9,"rating":{"score":"0.99","successRate":"0.81","reviews":9,"stars":"5.0","state":"rated"},"availabilityStatus":"healthy","priceObserved":{"p10Cents":"2.0000","medianCents":"2.0000","p90Cents":"2.0000","minCents":"2.0000","maxCents":"2.0000","p95Cents":"2.0000","sampleCount":6,"varies":false,"failureChargeRate":null},"sessionDeposit":null,"pricing":{"kind":"dynamic","summary":"$0.02/call","primary":{"kind":"dynamic","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"dynamic","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":"2","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_X8r7IC0XiG1lSlDXNufob","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null},{"uid":"pm_HmANh0DQjGncB4y-dqQZ6","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"2","costPer":"request","priority":0,"asset":"0x20c000000000000000000000b9537d11c60e8b50","unit":"request","depositMicros":null,"planRef":null}],"brandName":"StableUpload","brandSlug":"stableupload","brandBaseUrl":"https://stableupload.dev","brandDocsUrl":"https://stableupload.dev","whatItDoes":"Purchases a static site upload slot, returning a pre-signed URL to upload a zip file that can then be activated as a hosted static site.","exampleAgentPrompt":"Reserve a StableUpload static site slot for a zip file called 'portfolio.zip' using the 10mb tier, so I can upload it and serve it as a static website.","exampleUseCases":null,"resultDescription":"Returns an upload ID, a pre-signed upload URL (PUT or POST), the HTTP method to use, expiry timestamps for the upload URL and the hosted site, the maximum file size in bytes, and a ready-to-use curl command string for uploading the zip file.","failureModes":["Invalid or unsupported tier value returns a validation error","Filename exceeds 512 characters returns a bad request error","policyTtlSeconds outside the 60–86400 range returns a validation error","Payment of required USDC not received results in a 402 Payment Required response","Expired upload URL causes upload failure downstream","Uploading a file exceeding the tier's maxSize limit will be rejected"],"whenToPreferThis":"Use this endpoint when you need to deploy or host a static site by uploading a zip file and want pay-per-use pricing without a long-term subscription. It's ideal for short-lived workflow sites (7-day tiers) or standard 6-month hosting, especially when you need a pre-signed URL to push assets programmatically. Prefer this over generic object storage when you want the zip to be automatically extracted and served as a live website with optional custom domain support.","instructions":null,"reviewSummary":"Static site hosting via a three-step flow: purchase a slot (10 MB at $0.02 or 100 MB at $0.20), upload a zip to a presigned PUT URL, then activate to receive a live siteUrl with a 6-month TTL. All nine reviewers report success across a range of site types and sizes, with fast API responses and clean JSON output. Pricing shows minor inconsistency across reviews, and zip files must have index.html at the root level to extract correctly.","reviewSummaryHighlights":["Clean three-step deploy: slot purchase, presigned PUT upload, then activate — no account setup required","Supports up to 100 MB zips with multi-file sites including images, video, and WebGL assets","6-month hosting included; presigned URL includes a multi-hour upload window"],"reviewSummaryConcerns":["Reported slot price varies across reviews ($0.005 vs $0.02 for 10 MB tier)","zip must contain index.html at the root, not nested in a subfolder, or extraction will fail","Presigned upload URL expires per policyTtlSeconds — slot should not be purchased until the zip is ready"],"reviewSummaryGeneratedAt":"2026-09-14T22:15:09.058Z","activationCount":146,"lastUsedAt":"2026-09-19T01:28:20.576Z","lastSuccessfullyRanAt":"2026-09-15T13:11:50.828Z","lastHealthCheckAt":"2026-10-12T06:31:16.941Z","isFirstParty":false,"canonicalSlug":"stableupload-site-203504c8"}