Skip to main content
GET
Retrieve file metadata
Returns metadata only (id, size, filename, purpose, timestamps). For bytes use GET /v1/files//content. Workspace-scoped: cross-workspace lookup returns 404 (we don’t leak existence).

Authorizations

Authorization
string
header
required

API key in format: Bearer inf_***

Path Parameters

fileId
string
required

Response

File metadata

id
string
Example:

"file_1hR9xTPZqK4mVLc2nJ7fY5wB"

object
string
Example:

"file"

bytes
integer
Example:

245192

created_at
integer
Example:

1713204900

filename
string
Example:

"report.pdf"

purpose
enum<string>
Available options:
assistants,
vision,
user_data,
batch
Example:

"assistants"

status
string
Example:

"processed"