{"uid":"cap_wCFzbBNPwfAyK6dO1TRMS","slug":"stableupload-upload-c9737c54","name":"StableUpload File Upload Slot Purchase","description":"Buy an upload slot. Agent uploads file via returned URL.","url":"https://stableupload.dev/api/upload?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","required":["filename","contentType","tier"],"properties":{"tier":{"enum":["10mb","100mb","1gb","short-10mb","short-100mb","short-1gb","short-5gb"],"type":"string","description":"Upload tier. Default 6-month tiers: 10mb ($0.02), 100mb ($0.20), 1gb ($2.00). Short-term 7-day workflow tiers: short-10mb ($0.005), short-100mb ($0.02), short-1gb ($0.10), short-5gb ($0.50, file uploads only)."},"filename":{"type":"string","maxLength":512,"minLength":1,"description":"Name of the file to upload"},"contentType":{"type":"string","maxLength":255,"minLength":1,"description":"MIME type of the file (e.g. image/png, video/mp4)"},"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","publicUrl","expiresAt","maxSize","curlExample"],"properties":{"txHash":{"type":"string"},"maxSize":{"type":"number"},"postUrl":{"type":"string"},"uploadId":{"type":"string"},"expiresAt":{"type":"string"},"publicUrl":{"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":"10mb","filename":"test-document.pdf","contentType":"application/pdf"},"response":{"maxSize":10485760,"uploadId":"m2he4b6q8h","expiresAt":"2026-12-06T04:00:51.136Z","publicUrl":"https://f.stableupload.dev/m2he4b6q8h/test-document.pdf","uploadUrl":"https://f.stableupload.dev/m2he4b6q8h/test-document.pdf?t=09ph_FsyGIX6Gq11FaJl","curlExample":"curl -X PUT \"https://f.stableupload.dev/m2he4b6q8h/test-document.pdf?t=09ph_FsyGIX6Gq11FaJl\" -H \"Content-Type: application/pdf\" --data-binary @'test-document.pdf'","uploadMethod":"put","uploadUrlExpiresAt":"2026-06-09T05:00:51.965Z"}},"exampleRequest":{"tier":"10mb","filename":"test-document.pdf","contentType":"application/pdf"},"tags":["upload","files","hosting","static-site","cdn","storage"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":true,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":4,"rating":{"score":"0.96","successRate":"0.99","reviews":4,"stars":"4.8","state":"rated"},"availabilityStatus":"healthy","priceObserved":{"p10Cents":"2.0000","medianCents":"2.0000","p90Cents":"2.0000","minCents":"2.0000","maxCents":"2.0000","p95Cents":"2.0000","sampleCount":4,"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_YM0ax5rUePGzic4OA7-la","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_5yvW4ovdCo3IY03bblm-m","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 file upload slot and returns a pre-signed URL for the agent to upload a file directly to StableUpload CDN storage.","exampleAgentPrompt":"Upload my file 'report-Q4-2024.pdf' (it's a PDF, about 8MB) to StableUpload using the standard 6-month 10mb tier so I can share a public link with my team.","exampleUseCases":[{"title":"Generate shareable link for report","prompt":"I need to upload my quarterly earnings spreadsheet to the cloud and get back a public link I can send to the board members right away. Can you handle that for me?"},{"title":"Host temporary files for workflow","prompt":"We're processing customer documents through a workflow and need to store each one temporarily—maybe 7 days should be fine. Can you upload these files and give me the download links?"},{"title":"Share video file with client","prompt":"I've got a 50MB product demo video I need to get hosted somewhere public so I can email the client a working link. Can you take care of uploading it?"}],"resultDescription":"Returns an uploadId, a pre-signed uploadUrl (PUT or POST method) valid until uploadUrlExpiresAt, a permanent publicUrl where the file will be accessible, the maximum allowed file size in bytes, the expiry date of the hosted file, and a ready-to-use curl command for performing the upload.","failureModes":["Invalid or unsupported MIME contentType returns a 400 error","Filename exceeds 512 characters returns a validation error","Selected tier does not support the file size being uploaded","Insufficient USDC balance or payment failure results in 402 payment required","policyTtlSeconds outside 60-86400 range returns a validation error","Expired uploadUrl if agent waits too long before performing the actual upload"],"whenToPreferThis":"Use this endpoint when you need to host a file publicly on a CDN with a stable URL for 6 months (or 7 days for short-term workflow use), especially when the file will be shared, linked, or served as a static asset. Prefer this over site hosting endpoints when uploading single files rather than full zip-based static sites.","instructions":null,"reviewSummary":"This upload capability delivers a reliable two-step flow: purchase a slot, then upload via a returned presigned URL. All four reviewed uploads succeeded with correct content-type, content-length, and SHA-256 integrity. Fast slot issuance (~3s), immediate public URL availability, and competitive per-slot pricing make it well-suited for one-off agent-to-CDN file transfers, though single-use upload tokens mean re-uploading requires purchasing a new slot.","reviewSummaryHighlights":["Fast slot issuance with presigned URL returned in ~3 seconds","Public URLs serve files immediately with correct content-type and content-length","Strong integrity — SHA-256 and ETag verification confirmed accurate delivery"],"reviewSummaryConcerns":["Upload token is single-use; re-uploading a file requires purchasing a new slot"],"reviewSummaryGeneratedAt":"2026-09-21T06:15:10.541Z","activationCount":72,"lastUsedAt":"2026-09-18T22:20:44.634Z","lastSuccessfullyRanAt":"2026-09-18T22:20:44.634Z","lastHealthCheckAt":"2026-10-10T12:33:31.861Z","isFirstParty":false,"canonicalSlug":"stableupload-upload-c9737c54"}