Work with files

Some tools take a file, such as a receipt to upload, or return one, such as a statement to download. Pomerado keeps each file encrypted, only as long as the run needs it, and never opens it.

• Send a file to a run: give a tool’s file field a file ID, an https URL or a data: URI.
• Get a file from a run: download a file from the run’s result.

​

Who can use files

Files need a signed-in caller: a Dashboard session, an MCP client signed in to Pomerado, or an API key with runs:create. A file belongs to the person who uploaded it; anyone else gets not_found.

​

Limits

​

Accepted types

Pomerado accepts PDF, common image, audio and video types, ZIP and office documents, and text formats such as plain text, CSV, Markdown, XML and JSON. application/octet-stream takes any other bytes. A file’s first bytes must match its media type. Programs and scripts, such as .exe, .sh and .js files, are refused.

Details

Code	Meaning
file_too_large	The file is larger than details.max_bytes.
file_type_refused	An executable, an unsupported type, or bytes that don’t match the media type.
file_unavailable	The file expired, wasn’t uploaded yet, or another run already took it.
file_limit_exceeded	The run has too many files, or too many bytes in total.
file_fetch_failed	Pomerado couldn’t fetch a URL input; details.reason says why.

See errors for every code.