{"uid":"cap_-sAiObJQ_aNBRgtSkJbtW","slug":"koinelix-file-upload-0dc8931f","name":"Koinelix File Upload","description":"File upload that returns a signed download link valid for 10 days. Use when an agent holds a file and needs to hand it to a person, another agent or a tool as a URL: file sharing for 1 byte to 10 MiB. The request is multipart/form-data with one part named file, or JSON with the file as base64 (up to 8 MiB). Price: 0.004 USDC per file, paid with x402; no account or API key is needed.","url":"https://api.koinelix.com/v1/files?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"file":{"type":"string","description":"The file bytes as one multipart part named file."}}},"responseSchema":{"type":"json","example":{"data":{"url":"https://koinelix.com/oss/<bucket>/files/file_<32 hex>?AWSAccessKeyId=<id>&Expires=<unix>&Signature=<sig>","sha256":"<64 hex>","file_id":"file_<32 hex>","filename":"report.pdf","expires_at":"2026-11-05T00:00:00Z","size_bytes":1234,"content_type":"application/pdf"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","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.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_m0G1xMtnMyEEvLqwaJyzq","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Uploads a file (1 byte to 10 MiB) and returns a signed download URL valid for 10 days, paid per-file via x402 with no API key required.","exampleAgentPrompt":"Upload this PDF report I just generated and give me a download link I can share with my client — it's about 2 MB.","exampleUseCases":[{"title":"Agent hands file to human","prompt":"I just finished generating this CSV data export — can you upload it and send me a link so I can share it with my colleague?"},{"title":"Agent-to-agent file transfer","prompt":"The data processing agent needs to receive this JSON config file as a URL — please upload it and give me the download link to pass along."},{"title":"Sharing generated report as link","prompt":"Upload this 5 MB PDF invoice I created and give me a temporary download link that's good for a few days so I can send it to the customer."}],"resultDescription":"A signed HTTPS download URL for the uploaded file, valid for 10 days. The agent receives this URL and can share it with people, other agents, or tools that need to fetch the file by URL.","failureModes":["File exceeds 10 MiB limit — request rejected with an error indicating size exceeded","x402 payment fails or insufficient USDC balance — payment-required error returned","Malformed multipart/form-data or invalid base64 — 400 bad request","Base64 payload exceeds 8 MiB JSON limit — request rejected","Network timeout during upload of large file"],"whenToPreferThis":"Use this endpoint when an agent has a file in memory and needs to make it accessible as a URL — for sharing with a human, passing to another agent, or handing to a tool that only accepts URLs. Ideal for files up to 10 MiB that need a temporary 10-day link. No account or API key setup is required; payment is per-file via x402, making it frictionless for autonomous agents.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-11T13:30:11.436Z","isFirstParty":false,"canonicalSlug":"koinelix-file-upload-0dc8931f"}