Files

files

Methods

Retrieve File Content -> unknown
get/files/{file_id}/content

Returns the contents of the specified file.

Security
Bearer Auth

Example: Authorization: Bearer My API Key

Parameters
file_id: string
Request example
Upload File ->
post/files

Upload a file that can be used across various endpoints. Individual files can be up to 512 MB, and the size of all files uploaded by one organization can be up to 100 GB.

The Assistants API supports files up to 2 million tokens and of specific file types. See the Assistants Tools guide for details.

The Fine-tuning API only supports .jsonl files. The input also has certain required formats for fine-tuning chat or completions models.

The Batch API only supports .jsonl files up to 100 MB in size. The input also has a specific required format.

Please contact us if you need to increase these storage limits.

Delete File ->
delete/files/{file_id}

Delete a file.

List Files -> CursorPage<>
get/files

Returns a list of files.

Retrieve File ->
get/files/{file_id}

Returns information about a specific file.

Retrieve File Content ->
get/files/{file_id}/content

Returns the contents of the specified file.

Domain types

FileContent = string
FileDeleted = { id, deleted, object }
FileObject = { id, bytes, created_at, 5 more... }
FilePurpose = "assistants" | "batch" | "fine-tune" | 1 more...