{"uid":"cap_x4ZBowxbLfFhkI9d7qrb6","slug":"bounded-agent-utilities-temporary-utf-8-file-handoff-5a669922","name":"Bounded Agent Utilities – Temporary UTF-8 File Handoff","description":"Temporary UTF-8 file handoff, cited HTTPX migration evidence and block-pinned Base USDC balances. See each route for its price, limits and output contract.","url":"https://x402-46-225-191-113.sslip.io/v1/handoff?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"filename":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9 _-]{0,99}\\.([tT][xX][tT]|[cC][sS][vV]|[jJ][sS][oO][nN])$","maxLength":105},"data_base64":{"type":"string","maxLength":1398104}}},"responseSchema":{"type":"json","example":{"bytes":6,"sha256":"5891b5b522d5df086d0ff0b110fbd9d21bb4fc7163af34d08286a2e846f6be03","created_at":"2026-10-21T18:00:00Z","expires_at":"2026-10-28T18:00:00Z","artifact_id":"00000000000000000000000000000000","content_type":"text/plain; charset=utf-8","download_url":"https://example.invalid/artifacts/aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","downloads_remaining":10,"retention_policy_version":"public-text-7d-10-downloads-v1"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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.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_pA4W9M4Kbf3cXCDUX56Eh","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":"Accepts a base64-encoded UTF-8 file (TXT, CSV, or JSON) and stores it temporarily, returning a time-limited download URL with a SHA-256 checksum and download count.","exampleAgentPrompt":"Upload this report.csv file (base64-encoded) as a temporary handoff artifact so another agent can download it — I need the download URL, SHA-256 checksum, and expiry date back.","exampleUseCases":[{"title":"Agent pipeline data handoff","prompt":"Encode my analysis_results.json as base64 and upload it as a temporary artifact so the downstream processing agent can download it — give me the download URL and tell me when it expires."},{"title":"Share CSV export with time limit","prompt":"Take this base64-encoded export.csv and store it as a temporary file with a download link — I only want it accessible for the next 7 days and no more than 10 downloads."},{"title":"Cross-agent text file transfer","prompt":"I need to pass this summary.txt (base64-encoded) to another agent — upload it as a temporary handoff artifact and send me back the artifact ID and the SHA-256 checksum so I can verify it arrived intact."}],"resultDescription":"Returns a JSON object containing: the artifact ID (UUID), a temporary download URL, SHA-256 checksum of the file, file size in bytes, content type, creation and expiration timestamps, remaining allowed downloads, and the retention policy version applied. The download URL is valid for up to 7 days or 10 downloads, whichever comes first.","failureModes":["Filename does not match required pattern (alphanumeric, underscores, hyphens, must end in .txt/.csv/.json) — returns validation error","data_base64 exceeds 1,398,104 character limit (~1 MB encoded) — returns payload too large error","Invalid base64 encoding in data_base64 field — returns parse error","Payment not provided or insufficient USDC balance — returns 402 Payment Required","File content is not valid UTF-8 after decoding — may return encoding error"],"whenToPreferThis":"Choose this endpoint when an AI agent needs to temporarily share a small UTF-8 text, CSV, or JSON file with another agent or downstream process via a secure, expiring download URL. It is ideal for agent-to-agent handoffs where the file should self-destruct after a fixed number of downloads or time window. Prefer this over persistent storage when you want automatic expiry, a built-in integrity checksum, and micro-payment-gated access via the x402 protocol.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-22T12:30:29.077Z","isFirstParty":false,"canonicalSlug":"bounded-agent-utilities-temporary-utf-8-file-handoff-5a669922"}