List Files

Prerequisites

Endpoint and authentication configured. For details, see Overview and authentication.

Endpoint

GET /files

Query parameters

Parameter	Required	Type	Default	Description
`limit`	No	int	20	Number of items per page, maximum 100
`page`	No	string	—	Omit on the first call; pass `next_page` from the previous response for subsequent calls
`scope_id`	No	string	—	Pass a session ID to list only files within that session sandbox

Request example

curl "$AGENTSTUDIO_URL/files?limit=20" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY"

Response example

{
  "data": [
    {
      "id": "file_xxx",
      "type": "file",
      "filename": "sales_2025.csv",
      "downloadable": false,
      "mime_type": "text/csv",
      "size_bytes": 524288,
      "status": "available",
      "created_at": "2026-06-16T14:51:39+08:00"
    },
    {
      "id": "file_xxx",
      "type": "file",
      "filename": "demo.png",
      "downloadable": false,
      "mime_type": "image/png",
      "size_bytes": 102400,
      "status": "checking",
      "created_at": "2026-06-16T14:48:02+08:00"
    }
  ],
  "next_page": "xxx",
  "requestId": "xxx"
}

The response contains data (an array of File objects) and next_page. File object fields are as follows:

File object fields

Field	Type	Description
`id`	string	File ID, format: `file_<24 alphanumeric>`
`type`	string	Fixed value `file`
`filename`	string	Filename
`mime_type`	string	MIME type detected by the server
`size_bytes`	int	File size in bytes
`downloadable`	bool	Whether the file supports download; both direct uploads and session sandbox copies are `false`
`status`	string	Security review status: `available` / `checking` / `rejected` / `type_rejected`
`created_at`	string	Upload time, ISO 8601

​Prerequisites

​Endpoint

​Query parameters

​Request example

​Response example