List files API: GET /files-Alibaba Cloud Model Studio(Model Studio)-阿里云帮助中心

Lists files in the workspace with pagination, sorted by created_at in descending order. Use scope_id to list only files within a specific session sandbox.

Prerequisites

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

Endpoint

GET /files

Query parameters

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

Request example

Bash

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

Python

for file in client.files.list(limit=20):
    print(file.id, file.filename, file.size_bytes)

Java

CursorPage<AgentStudioFile> page = client.files().list(
    FileListParam.builder().limit(20).build());
for (AgentStudioFile f : page.getData()) {
    System.out.println(f.getId() + " " + f.getFilename() + " " + f.getSizeBytes());
}

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",
  "request_id": "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_<32 hex>`
`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