Skip to content
For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
Primary navigation

Suggested
Overview Models Agents Tools Audio & voice Production API reference

Files

Create container file
POST
/containers/{container_id}/files
Delete a container file
DELETE
/containers/{container_id}/files/{file_id}
List container files
GET
/containers/{container_id}/files
Retrieve container file
GET
/containers/{container_id}/files/{file_id}
Models
FileCreateResponse object { id, bytes, container_id, 4 more }
id: string

Unique identifier for the file.

bytes: number

Size of the file in bytes.

container_id: string

The container this file belongs to.

created_at: number

Unix timestamp (in seconds) when the file was created.

formatunixtime
object: string

The type of this object (container.file).

path: string

Path of the file in the container.

source: string

Source of the file (e.g., user, assistant).

FileDeleteResponse object { id, deleted, object }
id: string
deleted: boolean
object: "container.file.deleted"
FileListResponse object { id, bytes, container_id, 4 more }
id: string

Unique identifier for the file.

bytes: number

Size of the file in bytes.

container_id: string

The container this file belongs to.

created_at: number

Unix timestamp (in seconds) when the file was created.

formatunixtime
object: string

The type of this object (container.file).

path: string

Path of the file in the container.

source: string

Source of the file (e.g., user, assistant).

FileRetrieveResponse object { id, bytes, container_id, 4 more }
id: string

Unique identifier for the file.

bytes: number

Size of the file in bytes.

container_id: string

The container this file belongs to.

created_at: number

Unix timestamp (in seconds) when the file was created.

formatunixtime
object: string

The type of this object (container.file).

path: string

Path of the file in the container.

source: string

Source of the file (e.g., user, assistant).

FilesContent

Retrieve container file content
GET
/containers/{container_id}/files/{file_id}/content