Files

Download file content

Downloads the raw bytes of a file. Only files created server-side are downloadable; uploaded files return 400.

get/files/{file_id}/content

Path parameters

file_idstring required

Example:or_file_011CNha8iCJcU1wXNR6q4V8w

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 raw file content.

Changes

Changed in 2 of the 303 revisions of this API.214

Aug 26, 2026ed04e14f275521See the full diff
- ▲
  for the path request parameter file_id, the minLength was increased from 0 to 1
  request-parameter-min-length-increased
- ▲
  added the pattern ^[\w-]+$ to the path request parameter file_id
  request-parameter-pattern-added
- ●
  for the path request parameter file_id, the maxLength was set to 256
  request-parameter-max-length-set
Jul 29, 20266968addaaf974See the full diff
- ○
  added the new optional query request parameter provider
  new-optional-request-parameter
- ○
  added the non-success response with the status
  response-non-success-status-added
- ○
  added the non-success response with the status
  response-non-success-status-added
- ○
  added the non-success response with the status
  response-non-success-status-added
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog