Skip to main content
GET
Get file metadata

Authorizations

Authorization
string
header
required

API key as bearer token in Authorization header

Path Parameters

file_id
string
required
Example:

"or_file_011CNha8iCJcU1wXNR6q4V8w"

Query Parameters

workspace_id
string<uuid>

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

Example:

"a103d8b6-42f0-4e50-9a3c-bf41e2c3c1a7"

provider
enum<string>

Store or read this file on the named provider using your own API key for it. Omit to use OpenRouter storage.

Available options:
openai,
anthropic
Example:

"openai"

Response

The file metadata.

A stored file. The shape is negotiated per request — see the endpoint description.

_shape
enum<string>
required
Available options:
openrouter
created_at
string
required
downloadable
boolean
required
filename
string
required
id
string
required
mime_type
string
required
size_bytes
integer
required
type
enum<string>
required
Available options:
file