Limits
Upload a file
Ask for a one-time upload URL, thenPUT the raw bytes to it. The URL works once and expires after 15 minutes. It needs no API key, so keep it private.
PUT returns the file’s metadata. Pass its file_id as the endpoint’s file input.
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 usecreate_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.