{"uid":"cap_H6S_vgtBRw8pnpfGez1Sp","slug":"vaaya-file-upload-7ca129bc","name":"Vaaya File Upload","description":"Store a file from the local machine in your persistent Vaaya file library. Returns put_url (PUT the raw bytes there with curl) plus file_id and get_url. Files persist across tasks — check files/list before re-uploading. Max 100MB per file.","url":"https://vaaya.ai/api/run/files/upload","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["filename","size_bytes"],"properties":{"mime":{"type":"string","maxLength":100},"note":{"type":"string","maxLength":500},"tags":{"type":"array","items":{"type":"string","maxLength":40,"minLength":1},"maxItems":10},"filename":{"type":"string","maxLength":200,"minLength":1},"size_bytes":{"type":"integer","maximum":104857600,"exclusiveMinimum":0}},"additionalProperties":false},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"pathParams":{"type":"object"}},"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":"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.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_Vb5ckuMW0hUTkNGvq6je7","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Uploads files to the Vaaya platform for use in agent-powered workflows such as demos, outreach, and content generation.","exampleAgentPrompt":"Upload this file to Vaaya so I can use it in my agent workflow — here's the document I want to store.","exampleUseCases":[{"title":"Upload contact list for outreach","prompt":"Upload this CSV of prospect contacts to Vaaya so the agent can start enriching and reaching out to them."},{"title":"Store graphic asset for demo","prompt":"Upload this PNG graphic to Vaaya so the agent can include it in the product demo it's building."},{"title":"Submit document for go-to-market campaign","prompt":"Upload this one-pager PDF to Vaaya so my agent can use it as collateral in the go-to-market automation."}],"resultDescription":"Returns a confirmation of the upload along with a file reference (such as a URL or ID) that can be used by subsequent Vaaya agent workflow steps to access or process the uploaded file.","failureModes":["File too large — returns error if the file exceeds platform size limits","Unsupported file type — returns error if the MIME type is not accepted","Authentication or payment failure — x402 payment not completed, call rejected","Malformed request — missing file content or required multipart fields returns 400 error","Network timeout — large file uploads may time out"],"whenToPreferThis":"Choose this endpoint when you need to stage a file (document, image, spreadsheet, etc.) into the Vaaya platform before using it in downstream agent workflows such as demo building, outreach automation, contact enrichment, or graphic generation. This is the entry point for file-based assets in the Vaaya ecosystem.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:47:17.713Z","isFirstParty":false}