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.

Response

Successful Response

datalist of objects

List of file metadata objects for the current page.

first_idstring or null

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

last_idstring or null

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

has_morebooleanDefaults to false

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

Errors

401

Unauthorized Error

422

Unprocessable Entity Error

1	{
2	"data": [
3	{
4	"id": "uploads/data.csv",
5	"created_at": "2024-01-15T10:30:00Z",
6	"filename": "data.csv",
7	"mime_type": "text/csv",
8	"size_bytes": 4096,
9	"downloadable": false,
10	"scope": {
11	"id": "session-abc123",
12	"type": "session"
13	},
14	"type": "file"
15	}
16	],
17	"first_id": "uploads/data.csv",
18	"last_id": "outputs/result.png",
19	"has_more": false
20	}