{"uid":"cap_NIDZsSXkkyv23MFG66JoO","slug":"tempfile-0000402-xyz-060d2f63","name":"tempfile.0000402.xyz File Upload","description":"Pay $0.02 USDC to store a file for 7 days. Send filename, optional content_type, and base64-encoded file bytes as JSON. Max file size: 10 MB. Returns a token and a stable GET URL. Network: Base Mainnet. Each request stores one file and returns a retrieval token plus expiry timestamp.","url":"https://tempfile.0000402.xyz/upload","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"filename":{"type":"string","maxLength":200,"description":"Original filename including extension (max 200 chars). Used for download naming and content-type detection."},"data_base64":{"type":"string","description":"Base64-encoded file bytes for this upload. Decoded size must not exceed 10 MB."},"content_type":{"type":"string","description":"Optional MIME type such as 'image/png' or 'application/pdf'. If omitted, the server detects it from the filename extension."}}},"responseSchema":{"type":"json","example":{"url":"/file/a1b2c3d4-e5f6-7890-abcd-ef1234567890","token":"a1b2c3d4-e5f6-7890-abcd-ef1234567890","message":"File stored. Available at GET /file/a1b2c3d4-e5f6-7890-abcd-ef1234567890 for 7 days.","filename":"chart.png","expires_at":"2026-03-10T13:00:00+00:00","size_bytes":12345,"content_type":"image/png"}},"example":{"request":{"filename":"test_document.txt","data_base64":"VGhpcyBpcyBhIHRlc3QgZmlsZSBjb250ZW50Lg==","content_type":"text/plain"},"response":{"url":"/file/348c867e-c274-4d8f-84b7-397349294026","token":"348c867e-c274-4d8f-84b7-397349294026","message":"File stored. Available at GET /file/348c867e-c274-4d8f-84b7-397349294026 for 7 days (until 2026-06-05T20:40:06+00:00).","filename":"test_document.txt","expires_at":"2026-06-05T20:40:06+00:00","size_bytes":28,"content_type":"text/plain"}},"exampleRequest":{"filename":"test_document.txt","data_base64":"VGhpcyBpcyBhIHRlc3QgZmlsZSBjb250ZW50Lg==","content_type":"text/plain"},"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":2,"rating":{"score":"0.50","successRate":"0.62","reviews":2,"stars":"3.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":1,"varies":false,"failureChargeRate":1},"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_fQjcuq_cf4FwResdax6Mi","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Stores a base64-encoded file for 7 days and returns a stable retrieval URL and token, costing $0.02 USDC per upload.","exampleAgentPrompt":"Store this PDF file called 'invoice_april.pdf' for me temporarily — I'll give you the base64 content — and send back the URL I can use to retrieve it for the next 7 days.","exampleUseCases":null,"resultDescription":"Returns a JSON object with a stable GET URL path (e.g. /file/{uuid}), a retrieval token (UUID), a human-readable confirmation message stating the expiry date, the original filename, the expiry timestamp in ISO 8601 format, the file size in bytes, and the detected or provided content type.","failureModes":["File exceeds 10 MB limit — server returns an error rejecting the upload","Invalid or missing base64 data — malformed request body causes a 400-level error","Missing required filename field — request rejected","Payment not fulfilled — x402 payment protocol not satisfied, request blocked","Expired token used for retrieval — file no longer available after 7-day window","Unsupported content type — may cause unexpected storage behavior"],"whenToPreferThis":"Use this endpoint when an agent needs to temporarily host a file (up to 10 MB) and obtain a stable, publicly accessible GET URL valid for exactly 7 days, at a cost of $0.02 USDC per upload on Base Mainnet. Ideal for agentic workflows that need to pass file URLs between steps, share generated content, or stage documents without permanent storage infrastructure.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":26,"lastUsedAt":"2026-08-19T19:27:48.840Z","lastSuccessfullyRanAt":"2026-08-19T19:27:48.840Z","lastHealthCheckAt":"2026-09-14T17:51:54.223Z","isFirstParty":false}