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.
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).
Response
Successful Response