Sign in
files

List files in a session

List all files associated with a session, combining uploaded input files and sandbox-generated output files. Results are sorted by creation time and support cursor-based pagination.

get/v1/files

Query parameters

scope_idstring required

Session / container identifier.

limitinteger

Maximum number of files to return per page.

after_idstring nullable

Return files created after this file ID (exclusive). Used for forward pagination.

before_idstring nullable

Return files created before this file ID (exclusive). Used for backward pagination.

namespacestring

Namespace to list files from. Defaults to 'session'.

prefixstring nullable

Object-storage-style key prefix filter. When set, only files whose key starts with this prefix are returned (e.g. data/2024/ lists everything uploaded under that virtual folder). Works like S3 list-objects-v2 --prefix. The prefix is matched against the relative upload key, not the full canonical path.

Response

Successful Response

first_idstring nullable

ID of the first file in the current page, used for cursor-based pagination.

last_idstring nullable

ID of the last file in the current page, used for cursor-based pagination.

has_moreboolean

True when there are additional pages of results beyond this one.

Changes