Skip to main content
GET
Retrieve a container file

Authorizations

Authorization
string
header
required

API key as bearer token in Authorization header

Path Parameters

container_id
string
required

The canonical container id, exactly as returned in a bash/shell tool result — a restarted session has its own -r<nonce>-suffixed id. A session-derived id is always sess_ + the sanitized session key, which is not necessarily the raw session id that was sent.

Example:

"sess_abc123"

file_id
string
required

Container file id (cfile_ + base64url of the file path).

Example:

"cfile_b3V0L3JlcG9ydC5jc3Y"

Response

The container file.

bytes
integer
required

File size in bytes.

Example:

123

container_id
string
required

The container the file belongs to — echoes the container_id path parameter (OpenAI field name).

Example:

"sess_abc123"

created_at
integer
required

Unix timestamp (seconds) when the file was last synced.

Example:

1755640000

id
string
required

Container file id: cfile_ + base64url of the file path.

Example:

"cfile_b3V0L3JlcG9ydC5jc3Y"

object
enum<string>
required
Available options:
container.file
Example:

"container.file"

path
string
required

Container-relative file path.

Example:

"out/report.csv"

source
enum<string>
required

Container files are always produced by the assistant sandbox.

Available options:
assistant
Example:

"assistant"