workspace

List workspace files

List files in the user's workspace.

When session_id is provided, only files for that session are returned. Otherwise, all files across sessions are listed. Results are paginated via limit/offset; has_more indicates whether additional pages exist.

The Artifacts page uses q for name search and origin to filter between Uploaded (user-uploaded) and Generated (agent/block output) files.

session_id (a per-session view) and the folder filters (folder_id / root_only) are distinct, mutually exclusive axes, and folder_id and root_only likewise conflict; passing conflicting filters returns a 400 rather than silently yielding an empty list.

get/api/workspace/files

Query parameters

session_idstring nullable

limitinteger

offsetinteger

qstring nullable

Case-insensitive substring search on file name. Applied in the database for fresh results without waiting on embedding generation.

origin'uploaded' | 'generated' nullable

Filter by file origin. uploaded matches files the user uploaded (metadata.origin == 'user-upload', set by the upload endpoint for both Builder and CoPilot uploads); generated matches everything else (agent/block output). Ignored when session_id is set.

folder_idstring nullable

Only return files in this folder.

root_onlyboolean

Only return root-level files (not in any folder).

Response

Successful Response

offsetinteger

has_moreboolean

Changes

Changed in 4 of the 92 revisions of this API.358

Jul 1, 20268b99899127183See the full diff
- ○
  added the new optional query request parameter folder_id
  new-optional-request-parameter
- ○
  added the new optional query request parameter root_only
  new-optional-request-parameter
- ○
  added the optional property files/items/folder_id to the response with the 200 status
  response-optional-property-added
Jun 15, 20268007c86ad53123See the full diff
- ▲
  removed the enum value autopilot from the property anyOf[subschema #1]/ of the query request parameter origin
  request-parameter-property-enum-value-removed
- ▲
  removed the enum value builder from the property anyOf[subschema #1]/ of the query request parameter origin
  request-parameter-property-enum-value-removed
- ○
  added the enum value generated to the property anyOf[subschema #1]/ of the query request parameter origin
  request-parameter-property-enum-value-added
- ○
  added the enum value uploaded to the property anyOf[subschema #1]/ of the query request parameter origin
  request-parameter-property-enum-value-added
- ○
  added the required property files/items/origin to the response with the 200 status
  response-required-property-added
May 30, 20262163723f16ca2See the full diff
- ○
  added the new optional query request parameter origin
  new-optional-request-parameter
- ○
  added the new optional query request parameter q
  new-optional-request-parameter
Apr 30, 20268c84efcb3afb15See the full diff
- ▲
  removed the required property files/items/origin from the response with the 200 status
  response-required-property-removed
- ●
  deleted the query request parameter folder_id
  request-parameter-removed
- ●
  deleted the query request parameter origin
  request-parameter-removed
- ●
  deleted the query request parameter q
  request-parameter-removed
- ●
  deleted the query request parameter root_only
  request-parameter-removed
- ●
  removed the optional property files/items/folder_id from the response with the 200 status
  response-optional-property-removed
This revision also has 96 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history