List files in a session | PrivateGPT

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.

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