{"uid":"cap_stT3e4JgCmCHhvzBeyaM1","slug":"citiview-file-hosting-upload-share-files-c6e1b714","name":"Citiview File Hosting – Upload & Share Files","description":"File hosting: upload a file (text, base64 or copy from a URL) and get a public link that lasts up to 7 days. Images, PDF, text, Markdown, CSV, JSON and audio up to 1 MB. Served safely sandboxed. Also callable as GET with the same fields as query parameters.","url":"https://agents.citiviewgroup.com/v1/files?utm_source=zero.xyz","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"},"queryParams":{"type":"object","required":["name"],"properties":{"url":{"type":"string","description":"Copy a public file"},"days":{"type":"integer","description":"1 to 7 (default 7)"},"name":{"type":"string","description":"File name with extension, e.g. report.pdf"},"text":{"type":"string"},"content_base64":{"type":"string"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"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_9Gsg9StsVhTjIedMBAr4S","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":"Upload a file (text, base64, or copied from a public URL) and receive a public shareable link valid for up to 7 days.","exampleAgentPrompt":"Can you host this CSV text for me as a public file called 'sales_report.csv' and give me a shareable link that lasts 3 days?","exampleUseCases":[{"title":"Share generated report publicly","prompt":"I just generated a summary report as text — can you upload it as 'summary_report.txt' and give me a public link that lasts 5 days so I can share it with my team?"},{"title":"Rehost file from external URL","prompt":"There's a PDF at https://example.com/document.pdf — can you copy it and give me a sandboxed public link for it, named 'document.pdf', lasting 7 days?"},{"title":"Publish base64 image temporarily","prompt":"I have a base64-encoded PNG image I need to share publicly as 'chart.png' for just 2 days — can you host it and give me the link?"}],"resultDescription":"Returns a public URL to the hosted file that remains accessible for the specified number of days (1–7), served in a sandboxed environment. Supported file types include images, PDFs, text, Markdown, CSV, JSON, and audio files up to 1 MB.","failureModes":["File exceeds 1 MB size limit — request rejected","Unsupported file type provided — not accepted","Invalid base64 encoding — file cannot be decoded","Source URL is inaccessible or returns non-2xx — copy fails","Missing required 'name' field — request fails validation","Days value out of range (must be 1–7) — validation error"],"whenToPreferThis":"Use this endpoint when you need a quick, temporary public URL for a small file (text, PDF, CSV, JSON, Markdown, image, or audio) without setting up persistent storage infrastructure. Ideal for sharing agent-generated outputs, passing files between services via URL, or making a file accessible to a third party for up to 7 days. Prefer this over permanent storage when the file is ephemeral and the 1 MB limit is acceptable.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T06:48:25.113Z","isFirstParty":false,"canonicalSlug":"citiview-file-hosting-upload-share-files-c6e1b714"}