List, download, or preview files

GET 
/ai/playground/files

Omit action (or any value other than download/preview) to list files. List with chat_id returns that chat's files plus global files (chat_id is used as-is; pass project-files-{project_id} to list a project's files). List without chat_id returns accessible chat, project, and global files. Default offset 1, limit 5000 (max 5000), sortby UploadTime, sortorder desc. action=download or preview requires file_name; chat_id defaults to the user's global files (use global). project_id (not N/A) targets project files. Preview of csv/tsv/txt/json/sql returns {data}; otherwise {PresignedURL}. No request body.

Request

Responses

200

List returns paginated files. download/preview returns PresignedURL, except preview of csv/tsv/txt/json/sql which returns data.

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers

400

Input validation or authorization failure. Body is {"Message": " - "}. Codes: IPV-1001 (missing file_name for download/preview), IPV-1050 (limit over maximum), IPV-1002 (file/chat not found), AUTH-1001 (missing role_id), AUTH-1011 (caller not authorized).

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers

500

Backend failure. Body is {"Message": " - "}. Codes: GE-1008 (unexpected backend failure), DB-1002 (persistence failure).

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers