API ReferenceFiles

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.

Query parameters

scope_idstringRequired

Session / container identifier.

limitintegerOptional1-1000Defaults to 20
Maximum number of files to return per page.
after_idstring or nullOptional

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

before_idstring or nullOptional

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

namespacestringOptionalDefaults to session
Namespace to list files from. Defaults to 'session'.
prefixstring or nullOptional

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
datalist of objectsOptional
List of file metadata objects for the current page.
first_idstring or nullOptional

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

last_idstring or nullOptional

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

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

Errors

401
Unauthorized Error
422
Unprocessable Entity Error