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

List files

Changed on Jul 29, 2026

Lists files belonging to the workspace of the authenticating API key.

get/files

Request

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

Query parameters

limitinteger

Maximum number of files to return (1–1000).

Example:100

cursorstring

Opaque pagination cursor from a previous response.

Example:eyJjdXJzb3IiOiJvcl9maWxlXzAxMUNOaGE4aUNKY1Uxd1hOUjZxNFY4dyJ9

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

afterstring

OpenAI-style forward cursor: the id to list after.

Example:or_file_011CNha8iCJcU1wXNR6q4V8w

after_idstring

Anthropic-style forward cursor: the id to list after.

Example:or_file_011CNha8iCJcU1wXNR6q4V8w

before_idstring

Anthropic-style reverse cursor. Not supported by OpenRouter storage.

Example:or_file_011CNha8iCJcU1wXNR6q4V8w

order'asc' | 'desc'

Sort direction. Only asc is supported by OpenRouter storage.

Example:asc

Response

A page of files.

Example response

{
  "_shape": "openrouter",
  "cursor": null,
  "data": [],
  "first_id": null,
  "has_more": false,
  "last_id": null
}

Changes

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
- info
  added the new optional query request parameter after
- info
  added the new optional query request parameter after_id
- info
  added the new optional query request parameter before_id
- info
  added the new optional query request parameter order
- 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
- info
  added the non-success response with the status

Operation history