Sign in

v10

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-0643140398.0 KB
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.

Example:session-abc123

Session / container identifier.

limitinteger

Maximum number of files to return per page.

Example:20

Maximum number of files to return per page.

after_idstring nullable

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

Example:uploads/data.csv

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.

Example:outputs/result.png

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

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.

Example response

{
  "data": [
    {
      "created_at": "2024-01-15T10:30:00Z",
      "downloadable": false,
      "filename": "data.csv",
      "id": "uploads/data.csv",
      "mime_type": "text/csv",
      "scope": {
        "id": "session-abc123",
        "type": "session"
      },
      "size_bytes": 4096,
      "type": "file"
    }
  ],
  "first_id": "uploads/data.csv",
  "has_more": false,
  "last_id": "outputs/result.png"
}