Files

Upload File

client.beta.files.upload(, ?): BetaFileMetadata

POST/v1/files

List Files

client.beta.files.list(?, ?): Page<BetaFileMetadata>

GET/v1/files

Download File

client.beta.files.download(, ?, ?): Response

GET/v1/files/{file_id}/content

Get File Metadata

client.beta.files.retrieveMetadata(, ?, ?): BetaFileMetadata

GET/v1/files/{file_id}

Delete File

client.beta.files.delete(, ?, ?): BetaDeletedFile

DELETE/v1/files/{file_id}

Models

BetaDeletedFile { id, type }

id: string

ID of the deleted file.

type?: "file_deleted"

Deleted object type.

For file deletion, this is always "file_deleted".

defaultfile_deleted

BetaFileMetadata { id, created_at, filename, 5 more }

id: string

Unique object identifier.

The format and length of IDs may change over time.

created_at: string

RFC 3339 datetime string representing when the file was created.

formatdate-time

filename: string

Original filename of the uploaded file.

maxLength500

minLength1

mime_type: string

MIME type of the file.

maxLength255

minLength1

size_bytes: number

Size of the file in bytes.

minimum0

type: "file"

Object type.

For files, this is always "file".

downloadable?: boolean

Whether the file can be downloaded.

defaultfalse

scope?: BetaFileScope { id, type } | null

The scope of this file, indicating the context in which it was created (e.g., a session).

id: string

The ID of the scoping resource (e.g., the session ID).

type: "session"

The type of scope (e.g., "session").

BetaFileScope { id, type }

id: string

The ID of the scoping resource (e.g., the session ID).

type: "session"

The type of scope (e.g., "session").