{"uid":"cap_Y8keOs7Liu9WlsNU5RhS5","slug":"vaaya-file-upload-from-url-e30eda3f","name":"Vaaya File Upload from URL","description":"Fetch a file from a public URL into your persistent Vaaya file library (server-side — no local download needed). Returns file_id and get_url. Max 100MB per file.","url":"https://vaaya.ai/api/run/files/upload_from_url","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":["url"],"properties":{"url":{"type":"string","format":"uri"},"note":{"type":"string","maxLength":500},"tags":{"type":"array","items":{"type":"string","maxLength":40,"minLength":1},"maxItems":10},"filename":{"type":"string","maxLength":200,"minLength":1}},"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_18EOxT4_HAFzh6ePzhSJm","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":"Downloads a file from a given URL and uploads it into Vaaya's file storage, making it accessible for agent workflows","exampleAgentPrompt":"Grab the PDF at https://example.com/reports/q4.pdf and upload it into Vaaya so my agent can reference it in the next step of the workflow.","exampleUseCases":[{"title":"Ingest remote image for demo builder","prompt":"There's a product screenshot at https://mysite.com/assets/hero.png — can you pull it into Vaaya so I can use it when building the product demo?"},{"title":"Import document for outreach workflow","prompt":"Fetch the one-pager at https://partners.acme.com/deck.pdf and store it in Vaaya so my go-to-market agent can attach it to outreach emails."},{"title":"Load CSV for contact enrichment pipeline","prompt":"Download the contact list CSV from https://crm.example.com/exports/leads.csv and upload it to Vaaya so the enrichment agent can start processing it."}],"resultDescription":"Returns a reference to the uploaded file within Vaaya's storage system, including a file ID or accessible URL that downstream agent steps can use to retrieve or process the file.","failureModes":["Source URL is unreachable or returns a non-200 status — upload fails with a fetch error","URL points to an unsupported file type or oversized file — rejected with a validation error","Invalid or malformed URL provided — returns a bad request error","Network timeout fetching the remote file — returns a timeout error","Payment not included or insufficient — returns a 402 Payment Required error"],"whenToPreferThis":"Use this endpoint when you have a file hosted at a remote URL that needs to be ingested into Vaaya's ecosystem for use by downstream agent steps — particularly when building agent pipelines that need to reference, attach, or process external files without manually downloading and re-uploading them. Prefer this over generic cloud storage uploads when you're already working within the Vaaya agent platform and need the file immediately accessible to other Vaaya capabilities.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:46:41.361Z","isFirstParty":false}