{"uid":"cap_Eo54E4pRWKD2qFEZbXiuy","slug":"stableupload-uploads-9f189b23","name":"StableUpload List Uploads","description":"List upload metadata for the authenticated wallet, newest first. Use nextCursor for pagination.","url":"https://stableupload.dev/api/uploads?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"limit":{"type":"integer","default":50,"maximum":100,"minimum":1,"description":"Maximum uploads to return, 1-100. Default 50."},"cursor":{"type":"string","description":"Pagination cursor from the previous nextCursor."}}},"responseSchema":{"type":"object","required":["uploads"],"properties":{"uploads":{"type":"array","items":{"type":"object","required":["id","kind","isSite","filename","contentType","tier","maxSize","actualSize","publicUrl","siteUrl","fileCount","customHostname","status","pricePaid","expiresAt","createdAt"],"properties":{"id":{"type":"string"},"kind":{"enum":["file","site"],"type":"string","description":"Upload type. Use siteUrl, not publicUrl, to serve sites."},"tier":{"type":"string"},"isSite":{"type":"boolean"},"status":{"type":"string","description":"pending, uploaded, or expired. See guidance for lifecycle."},"maxSize":{"type":"number"},"siteUrl":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Activated site URL, or null for file uploads/unactivated sites."},"filename":{"type":"string"},"createdAt":{"type":"string"},"expiresAt":{"type":"string"},"fileCount":{"anyOf":[{"type":"number"},{"type":"null"}]},"pricePaid":{"type":"number"},"publicUrl":{"type":"string","description":"File URL for file uploads. For sites, this points to the source zip; serve activated sites from siteUrl."},"actualSize":{"anyOf":[{"type":"number"},{"type":"null"}]},"contentType":{"type":"string"},"customHostname":{"anyOf":[{"type":"string"},{"type":"null"}]}},"additionalProperties":false}},"nextCursor":{"type":"string"}},"additionalProperties":false},"example":{"request":{"limit":20},"response":{"uploads":[{"id":"zh33sqyqqp","kind":"site","tier":"short-10mb","isSite":true,"status":"pending","maxSize":10485760,"siteUrl":null,"filename":"mysite.zip","createdAt":"2026-05-29T23:08:14.074Z","expiresAt":"2026-06-05T23:08:14.046Z","fileCount":null,"pricePaid":0.005,"publicUrl":"https://f.stableupload.dev/zh33sqyqqp/mysite.zip","actualSize":null,"contentType":"application/zip","customHostname":null},{"id":"sys358mcgn","kind":"file","tier":"short-10mb","isSite":false,"status":"expired","maxSize":10485760,"siteUrl":null,"filename":"test-document.pdf","createdAt":"2026-05-29T23:07:08.829Z","expiresAt":"2026-06-05T23:07:08.792Z","fileCount":null,"pricePaid":0.005,"publicUrl":"https://f.stableupload.dev/sys358mcgn/test-document.pdf","actualSize":null,"contentType":"application/pdf","customHostname":null},{"id":"c37jpbsf7z","kind":"file","tier":"10mb","isSite":false,"status":"expired","maxSize":10485760,"siteUrl":null,"filename":"test-document.pdf","createdAt":"2026-05-29T00:57:22.117Z","expiresAt":"2026-11-25T00:57:22.108Z","fileCount":null,"pricePaid":0.02,"publicUrl":"https://f.stableupload.dev/c37jpbsf7z/test-document.pdf","actualSize":null,"contentType":"application/pdf","customHostname":null},{"id":"mx9ycerstt","kind":"site","tier":"10mb","isSite":true,"status":"pending","maxSize":10485760,"siteUrl":null,"filename":"portfolio.zip","createdAt":"2026-05-29T00:57:20.474Z","expiresAt":"2026-11-25T00:57:19.660Z","fileCount":null,"pricePaid":0.02,"publicUrl":"https://f.stableupload.dev/mx9ycerstt/portfolio.zip","actualSize":null,"contentType":"application/zip","customHostname":null},{"id":"aj2n74ewvm","kind":"file","tier":"10mb","isSite":false,"status":"expired","maxSize":10485760,"siteUrl":null,"filename":"sample-document.pdf","createdAt":"2026-04-25T04:03:11.528Z","expiresAt":"2026-10-22T04:03:11.518Z","fileCount":null,"pricePaid":0.02,"publicUrl":"https://f.stableupload.dev/aj2n74ewvm/sample-document.pdf","actualSize":null,"contentType":"application/pdf","customHostname":null},{"id":"we9n8ey64y","kind":"site","tier":"10mb","isSite":true,"status":"pending","maxSize":10485760,"siteUrl":null,"filename":"mysite.zip","createdAt":"2026-04-25T04:03:09.217Z","expiresAt":"2026-10-22T04:03:08.610Z","fileCount":null,"pricePaid":0.02,"publicUrl":"https://f.stableupload.dev/we9n8ey64y/mysite.zip","actualSize":null,"contentType":"application/zip","customHostname":null},{"id":"v635c7ab9a","kind":"file","tier":"10mb","isSite":false,"status":"expired","maxSize":10485760,"siteUrl":null,"filename":"test-upload.txt","createdAt":"2026-04-23T14:16:15.578Z","expiresAt":"2026-10-20T14:16:15.559Z","fileCount":null,"pricePaid":0.02,"publicUrl":"https://f.stableupload.dev/v635c7ab9a/test-upload.txt","actualSize":null,"contentType":"text/plain","customHostname":null},{"id":"dqq55zyqfj","kind":"site","tier":"10mb","isSite":true,"status":"expired","maxSize":10485760,"siteUrl":null,"filename":"mysite.zip","createdAt":"2026-04-23T14:16:10.603Z","expiresAt":"2026-10-20T14:16:10.380Z","fileCount":null,"pricePaid":0.02,"publicUrl":"https://f.stableupload.dev/dqq55zyqfj/mysite.zip","actualSize":null,"contentType":"application/zip","customHostname":null},{"id":"bfzmsr3ts3","kind":"file","tier":"10mb","isSite":false,"status":"expired","maxSize":10485760,"siteUrl":null,"filename":"sample.png","createdAt":"2026-04-17T15:48:59.244Z","expiresAt":"2026-10-14T15:48:58.447Z","fileCount":null,"pricePaid":0.02,"publicUrl":"https://f.stableupload.dev/bfzmsr3ts3/sample.png","actualSize":null,"contentType":"image/png","customHostname":null},{"id":"zbzxsmg6v6","kind":"site","tier":"10mb","isSite":true,"status":"pending","maxSize":10485760,"siteUrl":null,"filename":"mysite.zip","createdAt":"2026-04-16T13:44:49.218Z","expiresAt":"2026-10-13T13:44:48.476Z","fileCount":null,"pricePaid":0.02,"publicUrl":"https://f.stableupload.dev/zbzxsmg6v6/mysite.zip","actualSize":null,"contentType":"application/zip","customHostname":null},{"id":"er2ynaa8ae","kind":"file","tier":"10mb","isSite":false,"status":"expired","maxSize":10485760,"siteUrl":null,"filename":"test-document.pdf","createdAt":"2026-04-16T00:05:43.355Z","expiresAt":"2026-10-13T00:05:43.323Z","fileCount":null,"pricePaid":0.02,"publicUrl":"https://f.stableupload.dev/er2ynaa8ae/test-document.pdf","actualSize":null,"contentType":"application/pdf","customHostname":null},{"id":"cxwe6853vr","kind":"site","tier":"10mb","isSite":true,"status":"expired","maxSize":10485760,"siteUrl":null,"filename":"mysite.zip","createdAt":"2026-04-16T00:05:26.641Z","expiresAt":"2026-10-13T00:05:25.874Z","fileCount":null,"pricePaid":0.02,"publicUrl":"https://f.stableupload.dev/cxwe6853vr/mysite.zip","actualSize":null,"contentType":"application/zip","customHostname":null},{"id":"xf5m2qvv7g","kind":"file","tier":"10mb","isSite":false,"status":"uploaded","maxSize":10485760,"siteUrl":null,"filename":"la-tacos.html","createdAt":"2026-04-06T21:45:47.627Z","expiresAt":"2026-10-03T21:45:47.593Z","fileCount":null,"pricePaid":0.02,"publicUrl":"https://f.stableupload.dev/xf5m2qvv7g/la-tacos.html","actualSize":18508,"contentType":"text/html","customHostname":null},{"id":"8hdcejp9tn","kind":"site","tier":"10mb","isSite":true,"status":"uploaded","maxSize":10485760,"siteUrl":null,"filename":"la-tacos.html","createdAt":"2026-04-06T21:45:28.193Z","expiresAt":"2026-10-03T21:45:27.439Z","fileCount":null,"pricePaid":0.02,"publicUrl":"https://f.stableupload.dev/8hdcejp9tn/la-tacos.html","actualSize":18508,"contentType":"application/zip","customHostname":null},{"id":"b67g7dv8vn","kind":"site","tier":"10mb","isSite":true,"status":"uploaded","maxSize":10485760,"siteUrl":null,"filename":"stocks.html","createdAt":"2026-04-06T20:13:53.746Z","expiresAt":"2026-10-03T20:13:53.682Z","fileCount":null,"pricePaid":0.02,"publicUrl":"https://f.stableupload.dev/b67g7dv8vn/stocks.html","actualSize":6783,"contentType":"application/zip","customHostname":null},{"id":"ajy94mgmqf","kind":"site","tier":"10mb","isSite":true,"status":"uploaded","maxSize":10485760,"siteUrl":null,"filename":"stocks.html","createdAt":"2026-04-06T20:10:39.245Z","expiresAt":"2026-10-03T20:10:39.214Z","fileCount":null,"pricePaid":0.02,"publicUrl":"https://f.stableupload.dev/ajy94mgmqf/stocks.html","actualSize":9,"contentType":"application/zip","customHostname":null},{"id":"ee47hmkg4v","kind":"site","tier":"10mb","isSite":true,"status":"uploaded","maxSize":10485760,"siteUrl":null,"filename":"stocks.html","createdAt":"2026-04-06T20:10:07.488Z","expiresAt":"2026-10-03T20:10:06.808Z","fileCount":null,"pricePaid":0.02,"publicUrl":"https://f.stableupload.dev/ee47hmkg4v/stocks.html","actualSize":9,"contentType":"application/zip","customHostname":null},{"id":"7y38qgx4t2","kind":"site","tier":"10mb","isSite":true,"status":"uploaded","maxSize":10485760,"siteUrl":null,"filename":"taco-shops-la.html","createdAt":"2026-04-06T19:52:23.668Z","expiresAt":"2026-10-03T19:52:22.873Z","fileCount":null,"pricePaid":0.02,"publicUrl":"https://f.stableupload.dev/7y38qgx4t2/taco-shops-la.html","actualSize":10503,"contentType":"application/zip","customHostname":null}]}},"exampleRequest":{"limit":20},"tags":["upload","files","hosting","static-site","cdn","storage"],"displayCostAmount":"0","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"proven_free","priceSource":"registry","requiresHandshake":false,"reviewCount":1,"rating":{"score":"1.00","successRate":"1.00","reviews":1,"stars":"5.0","state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"free","summary":"Free","primary":{"kind":"free","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"free","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_9mVrSaeWpLjqptOedFX5E","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0","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":"Lists upload metadata for the authenticated wallet, paginated newest-first, including file and site uploads with status, URLs, and expiry info.","exampleAgentPrompt":"Show me my last 20 uploads on StableUpload — I want to see which ones are still active and what their public URLs are.","exampleUseCases":null,"resultDescription":"A JSON object containing an array of up to 100 upload records (newest first), each with ID, kind (file or site), filename, content type, tier, max/actual size, public URL, site URL, file count, custom hostname, status (pending/uploaded/expired), price paid, expiry date, and creation date. Also includes a nextCursor string for pagination if more results exist.","failureModes":["Unauthenticated request returns 401 — wallet auth header missing or invalid","limit out of range (< 1 or > 100) returns 400 validation error","Invalid cursor value returns 400 or empty result set","No uploads for wallet returns empty uploads array","Service unavailable returns 5xx"],"whenToPreferThis":"Use this endpoint when you need to audit, paginate through, or inspect the authenticated wallet's upload history on StableUpload — especially to retrieve public/site URLs, check expiry, or verify status of previously created uploads. Prefer this over fetching a single upload by ID when you don't know the specific upload ID or need a full inventory.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":2,"lastUsedAt":"2026-08-18T17:46:21.953Z","lastSuccessfullyRanAt":"2026-08-18T17:46:21.953Z","lastHealthCheckAt":"2026-10-12T00:35:28.650Z","isFirstParty":false,"canonicalSlug":"stableupload-uploads-9f189b23"}