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.
expert_id narrows the listing to files from that hired expert's own conversations. It excludes the other axes for the same reason. An expert the caller does not own (or no longer has) yields an empty list.
Query parameters
Case-insensitive substring search on file name. Applied in the database for fresh results without waiting on embedding generation.
Case-insensitive substring search on file name. Applied in the database for fresh results without waiting on embedding generation.
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.
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.
Only return files in this folder.
Only return files in this folder.
Only return root-level files (not in any folder).
Only return root-level files (not in any folder).
Only return files from this hired expert's conversations. Cannot be combined with session_id, folder_id or root_only.
Only return files from this hired expert's conversations. Cannot be combined with session_id, folder_id or root_only.
Response
Successful Response