Skip to main content
GET
List container files

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"

Query Parameters

limit
integer
default:100

Maximum number of files to return (1-1000). Defaults to 100 when absent.

Required range: 1 <= x <= 1000
Example:

100

after
string

Forward cursor: a container file id from a previous page (typically last_id); listing resumes strictly after that file.

Example:

"cfile_b3V0L3JlcG9ydC5jc3Y"

Response

The files in the container.

data
object[]
required
first_id
string | null
required
Example:

"cfile_b3V0L3JlcG9ydC5jc3Y"

has_more
boolean
required

True when another page can be fetched by passing after=last_id.

Example:

false

last_id
string | null
required
Example:

"cfile_b3V0L3JlcG9ydC5jc3Y"

object
enum<string>
required
Available options:
list
Example:

"list"