Files
Upload a file
Uploads a file to be referenced in future API calls. The file is stored under the workspace of the authenticating API key. Maximum file size: 100 MB.
post/files
Query parameters
workspace_idstring uuid
Workspace to scope the request to. Defaults to the caller’s default workspace.
Example:a103d8b6-42f0-4e50-9a3c-bf41e2c3c1a7
Workspace to scope the request to. Defaults to the caller’s default workspace.
provider'openai' | 'anthropic'
Store or read this file on the named provider using your own API key for it. Omit to use OpenRouter storage.
Example:openai
Store or read this file on the named provider using your own API key for it. Omit to use OpenRouter storage.
Response
The uploaded file metadata.
Example response
{
"_shape": "openrouter",
"created_at": "2025-01-01T00:00:00Z",
"downloadable": false,
"filename": "document.pdf",
"id": "or_file_011CNha8iCJcU1wXNR6q4V8w",
"mime_type": "application/pdf",
"size_bytes": 1024000,
"type": "file"
}