{"uid":"cap_PCiYDQFut5xgyMyZ6cJZ9","slug":"datastore-api-temporary-item-storage-ea82bc68","name":"DataStore API – Temporary Item Storage","description":"Store JSON or a file (up to 25 MB) privately for 7 days and hand it to a human or another agent with a signed link or a password-protected address. Includes 100 reads. No account needed: pay $0.01 per call here, or use prepaid credits with an API key, or store public items free at /v1/free/items. Docs: https://fileshareforagents.online/llms.txt","url":"https://fileshareforagents.online/v1/items?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","description":"The raw content to store is the request body (JSON shown here; text, Markdown, CSV, HTML, SVG, PDF, PNG, JPEG, WebP or GIF also accepted, up to 26214400 bytes). Options are query parameters: ttl_days (1..365, default 7) and label (<= 100 chars). The response holds the item id, a one-time secret, expiry, and links to retrieve, extend, buy reads, share and delete. Alternatives: POST /v1/free/items stores a public item for up to 7 days at no cost; an X-Api-Key from a dashboard account pays with prepaid credits instead of x402. See /llms.txt.","additionalProperties":true},"type":{"type":"string","const":"http"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["id","secret","expires_at","links"],"properties":{"id":{"type":"string"},"links":{"type":"object"},"secret":{"type":"string","description":"Bearer credential for every later call on this item. Shown once."},"expires_at":{"type":"string","format":"date-time"},"reads_remaining":{"type":"integer"}}}}}}},"responseSchema":{"type":"json","example":{"id":"itm_Dknq-kzeOK-HrU3O-HezFA","size":46,"links":{"self":"https://fileshareforagents.online/v1/items/{id}","reads":"https://fileshareforagents.online/v1/items/{id}/reads","share":"https://fileshareforagents.online/v1/items/{id}/links","delete":"https://fileshareforagents.online/v1/items/{id}","extend":"https://fileshareforagents.online/v1/items/{id}/extend","public":"https://share.fileshareforagents.online/d/{id}","status":"https://fileshareforagents.online/v1/items/{id}/status"},"secret":"sk_<shown once>","payment":{"tx":"0x...","amount":"0.01","network":"base","currency":"USDC"},"created_at":"2026-09-17T17:46:35.362Z","expires_at":"2026-09-24T17:46:35.362Z","content_type":"application/json","has_password":false,"reads_remaining":100}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_8F68Q_LwRp20u4yok8aSD","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Stores any content (JSON, text, Markdown, CSV, HTML, image, PDF, etc.) for up to 365 days (default 7) and returns a unique item ID, a one-time secret, expiry timestamp, and links to retrieve, extend, share, or delete the item.","exampleAgentPrompt":"Save this JSON payload for me so I can share it with another agent — keep it for 7 days and label it 'order-summary': {\"orderId\": \"ORD-4821\", \"total\": 49.99, \"status\": \"confirmed\"}.","exampleUseCases":[{"title":"Passing workflow state between agents","prompt":"Store this JSON object for 3 days so the downstream fulfillment agent can fetch it later — label it 'checkout-state': {\"cartId\": \"crt_99\", \"userId\": \"u_42\", \"items\": [{\"sku\": \"ABC\", \"qty\": 2}]}."},{"title":"Sharing a generated report via link","prompt":"I just generated a Markdown report — can you upload it and give me a public link I can send to my client? Keep it available for 14 days."},{"title":"Temporary image handoff between pipeline steps","prompt":"Save this product screenshot PNG for 1 day so the image-analysis agent in the next pipeline step can download it — label it 'product-img-step2'."}],"resultDescription":"A JSON object containing: item ID (e.g. itm_Dknq-...), a one-time bearer secret (shown only once, required for all subsequent operations on the item), expiry datetime, content type, size in bytes, remaining reads count, and a set of HTTPS links for self-retrieval, reads tracking, sharing, extending TTL, deleting, and a public download URL.","failureModes":["Payload exceeds 26,214,400 bytes — request rejected","ttl_days outside 1–365 range — validation error","Label longer than 100 characters — validation error","Payment not included or insufficient (x402 payment required, 0.01 USDC on Base)","Unsupported content type — rejection","Network timeout on large uploads","Secret lost after initial response — item becomes unmanageable (no recovery)"],"whenToPreferThis":"Choose this endpoint when an AI agent needs to temporarily persist arbitrary content (JSON, text, CSV, images, PDFs, etc.) and retrieve it later via a stable URL, especially in multi-agent pipelines, cross-session handoffs, or when a shareable public download link is needed. Prefer it over in-memory state when data must survive beyond a single session or be accessible to external agents or humans. The x402 micropayment model (0.01 USDC) makes it suitable for agent-native, wallet-enabled workflows.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-17T00:37:43.625Z","isFirstParty":false,"canonicalSlug":"datastore-api-temporary-item-storage-ea82bc68"}