{"uid":"cap_G4fu39_eNAfZgDwGlb8mv","slug":"agent-file-slot-b899acc1","name":"Agent File Slot","description":"Get a signed upload URL and a retrieval URL for one file, in one call. Your agent PUTs the bytes straight to storage — they never pass through this API, so there is no size ceiling imposed by a serverless runtime and no proxy in the middle. Declare bytes= and the size is signed into the URL. Up to 25 MB, retention 1-30 days, unguessable key. The step every agent hits the moment it produces a report, chart, CSV or build and has nowhere to put it.","url":"https://402.com.tr/api/x402/file-slot","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"pathParams":{"type":"object"},"queryParams":{"type":"object","required":["bytes"],"properties":{"name":{"type":"string","description":"File name (optional hint)"},"bytes":{"type":"string","description":"Exact file size in bytes"},"ttlDays":{"type":"string","description":"Retention in days (optional)"},"contentType":{"type":"string","description":"Content type (optional)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":1,"rating":{"score":"0.50","successRate":"0.00","reviews":1,"stars":"3.0","state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_QodGqUBTCNXvrw9nUPRHw","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a signed PUT URL and retrieval URL so an agent can upload a file directly to storage without routing bytes through this API","exampleAgentPrompt":"Get me a file slot for a 4200000-byte CSV named 'sales-report.csv' that should stick around for 7 days, then I'll upload it directly.","exampleUseCases":[{"title":"Storing a generated analytics report","prompt":"My agent just finished generating a 2.5 MB PDF analytics report — get me a signed upload slot for it named 'analytics-report.pdf' with 14 days retention so I can share the link with the team."},{"title":"Temporary chart image hosting","prompt":"I need somewhere to PUT a 800000-byte PNG chart my agent rendered — can you provision a file slot for 'monthly-chart.png' that stays live for 3 days?"},{"title":"Agent build artifact upload","prompt":"My CI agent just produced a 15 MB build artifact called 'app-build.zip' — get a signed slot for it with 30-day retention so the deployment agent can pull it later."}],"resultDescription":"Returns a signed PUT URL (for the agent to upload bytes directly to object storage) and a permanent retrieval URL. The signed URL encodes the exact allowed file size and optionally content type, so the upload is validated at the storage layer. No bytes pass through this API.","failureModes":["Missing required 'bytes' parameter returns a 400 error","File size exceeding 25 MB limit is rejected","TTL outside 1–30 day range is rejected","Expired signed URL results in a 403 on the subsequent PUT","Malformed content type may cause storage-layer rejection"],"whenToPreferThis":"Use this endpoint when your agent has produced any file artifact — report, chart, CSV, binary — and needs a place to store it without routing through a serverless proxy. Prefer it over base64-in-response approaches when files exceed a few KB, or when you need a shareable retrieval URL. Ideal for pipelines where the producer and consumer are decoupled and the file needs to persist for hours to days.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":2,"lastUsedAt":"2026-08-12T05:20:10.753Z","lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:55:09.539Z","isFirstParty":false}