OpenAI API | Files › Retrieve File

OpenAI API

Files

files

Methods

Retrieve File Content -> unknown

get/files/{file_id}/content

Returns the contents of the specified file.

Upload File ->

FileObject

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 ->

FileDeleted

delete/files/{file_id}

Delete a file.

List Files -> CursorPage<

FileObject

get/files

Returns a list of files.

Retrieve File ->

FileObject

get/files/{file_id}

Returns information about a specific file.

Security

Bearer Auth

Example: Authorization: Bearer My API Key

Parameters

file_id: string

Response fields

FileObject

Request example

curl https://api.openai.com/v1/files/$FILE_ID \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $OPENAI_API_KEY"

200Example

{
  "id": "id",
  "bytes": 0,
  "created_at": 0,
  "filename": "filename",
  "object": "file",
  "purpose": "assistants",
  "status": "uploaded",
  "status_details": "status_details"
}

Retrieve File Content ->

FileContent

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...