alpha.decisions1

Analytics3

Anthropic Messages1

API Keys6

Batch4

Benchmarks1

BYOK5

Chat1

Classifications1

Containers4

Credits2

Datasets3

Embeddings2

End Users5

Endpoints2

Files5

Generations3

Guardrails13

Images3

Interns13

Models4

OAuth4

Observability5

Organization3

Presets7

Private Endpoints10

Providers1

Rerank1

Responses1

SCIM8

STT1

SystemOne1

Tools2

TTS1

Vault8

Video Generation4

Workspaces12

Files

Upload a file

Changed on Oct 14, 2026

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; empty files are rejected. The file type is determined from the file contents — not the filename or the declared content type — and must be a PDF, a PNG/JPEG/GIF/WebP image, a DOCX/XLSX/PPTX document, an MP3/WAV/FLAC/OGG audio file, or UTF-8 text. Text is reported by its structure as application/json, application/x-ndjson, text/csv, text/markdown, or text/plain.

post/files

Request

Base URL: https://openrouter.ai/api/v1
URL: https://openrouter.ai/api/v1/files
Auth: HTTP bearer

Query parameters

workspace_idstring uuid

Workspace to scope the request to. Defaults to the caller’s default workspace.

Example:a103d8b6-42f0-4e50-9a3c-bf41e2c3c1a7

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

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"
}

Changes

Oct 14, 202644cbdb6e22e2 Revision changes
- info
  added the non-success response with the status
Jul 29, 20266968addaaf97 Revision changes
- breaking
  added to the response body oneOf list for the response status
- breaking
  the response's body type changed from object to no type for status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- info
  added the new optional query request parameter provider
- info
  added response discriminator for the response status
- info
  added the non-success response with the status
- info
  added the non-success response with the status

Operation history