File

List Files

Paginated list of files

GET

/api/v1/agentstudio/files

cURL

curl --request GET \
  --url 'https://{workspace_id}.{region}.maas.aliyuncs.com/api/v1/agentstudio/files' \
  --header 'Authorization: Bearer <YOUR_API_KEY>'

{
  "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"
}

Authorizations

string

header

required

DashScope API Key

Query Parameters

integer

default20

每页数量，最大 100

string

首次不传，后续传上一次响应的 next_page

string

传入会话 ID，仅返回该会话沙箱内的文件

Response

200-application/json

object[]

File 对象数组

Show child attributes

string

文件 ID，格式 file_<24 alphanumeric>（小写字母和数字，如 file_r4bznj1bnj73eaqpjljeu5el）

string

固定为 file

string

文件名

boolean

是否支持下载，当前接口直传与会话沙箱拷贝均为 false

string

服务端检测的 MIME 类型

integer

文件大小，单位字节

enum<string>

安全审核状态：available / checking / rejected / type_rejected

Available options:available,checking,rejected,type_rejected

string

上传时间，ISO 8601

string

下一页游标，传入下次请求的 page 参数

string

本次请求的唯一标识

cURL

curl --request GET \
  --url 'https://{workspace_id}.{region}.maas.aliyuncs.com/api/v1/agentstudio/files' \
  --header 'Authorization: Bearer <YOUR_API_KEY>'

{
  "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"
}