File

Upload Files

Upload files to a workspace

POST

/api/v1/agentstudio/files

cURL

curl --request POST \
  --url 'https://{workspace_id}.{region}.maas.aliyuncs.com/api/v1/agentstudio/files' \
  --header 'Authorization: Bearer <YOUR_API_KEY>' \
  --header 'Content-Type: multipart/form-data' \
  --data '
{
  "file": "<string>"
}
'

{
  "id": "file_xxx",
  "type": "file",
  "filename": "sales_2025.csv",
  "downloadable": false,
  "mime_type": "text/csv",
  "size_bytes": 524288,
  "status": "checking",
  "created_at": "2026-06-16T14:51:39+08:00",
  "requestId": "xxx"
}

Authorizations

string

header

required

DashScope API Key

Body

multipart/form-data

file

required

要上传的文件，最大 10 MB。filename 自动从表单部分获取，mime_type 由服务端检测

Response

200-application/json

string

文件 ID，格式 file_<24位字母数字>（如 file_maznwes8t9rsysg5r5enkvpr）

string

固定为 file

string

文件名（自上传时表单部分解析得到）

boolean

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

string

服务端检测的 MIME 类型

integer

文件大小，单位字节

enum<string>

安全审核状态：available（通过，可挂载）/ checking（审核中）/ rejected（内容未通过）/ type_rejected（类型不支持）。新上传文件默认 checking

Available options:checking,available,rejected,type_rejected

string

上传时间，ISO 8601

string

本次请求的唯一标识。Python SDK 中对应属性为 request_id

cURL

curl --request POST \
  --url 'https://{workspace_id}.{region}.maas.aliyuncs.com/api/v1/agentstudio/files' \
  --header 'Authorization: Bearer <YOUR_API_KEY>' \
  --header 'Content-Type: multipart/form-data' \
  --data '
{
  "file": "<string>"
}
'

{
  "id": "file_xxx",
  "type": "file",
  "filename": "sales_2025.csv",
  "downloadable": false,
  "mime_type": "text/csv",
  "size_bytes": 524288,
  "status": "checking",
  "created_at": "2026-06-16T14:51:39+08:00",
  "requestId": "xxx"
}