Skip to main content
Some endpoints upload a file to the site, such as a receipt, a résumé or an invoice, and some return one, such as a statement PDF. Peel keeps those files encrypted, owned by your account, for one hour.

Limits

Upload a file

Ask for a one-time upload URL, then PUT the raw bytes to it. The URL works once and expires after 15 minutes. It needs no API key, so keep it private.
The PUT returns the file’s metadata. Pass its file_id as the endpoint’s file input.
For small files you can instead send base64 in one request: POST /v1/files with name, mime_type and data_base64.

Download a file

An endpoint that saves a file returns its metadata (file_id, name, mime_type, size, sha256). Download the bytes with:
GET /v1/files/{file_id} returns the same file as base64 JSON when it is 5 MB or smaller. DELETE /v1/files/{file_id} removes it before it expires.

From an agent

The MCP server has the same tools. Agents should use create_file_upload and then curl -T, so the file never passes through the conversation. upload_file and get_file take and return base64 and are meant for small files.