Skip to main content
Agent

List Agent Versions

Paginated list of all historical versions of an Agent

GET
/api/v1/agentstudio/agents/{agent_id}/versions
cURL
curl --request GET \
  --url 'https://{workspace_id}.{region}.maas.aliyuncs.com/api/v1/agentstudio/agents/{agent_id}/versions' \
  --header 'Authorization: Bearer <YOUR_API_KEY>'
{
  "data": [
    {
      "id": "agent_xxx",
      "type": "agent",
      "version": 2,
      "name": "data-analyst",
      "description": "数据分析助手",
      "model": {
        "id": "qwen3-max"
      },
      "system": "你是资深数据分析师,输出结论时附带置信度。",
      "tools": [],
      "mcp_servers": [],
      "skills": [],
      "multiagent": {
        "type": "coordinator",
        "agents": [
          {
            "type": "self"
          },
          {
            "type": "agent",
            "id": "agent_researcher",
            "version": 3
          }
        ]
      },
      "metadata": {
        "team": "data"
      },
      "created_at": "2026-05-28T17:10:02.789+08:00",
      "updated_at": "2026-05-28T17:10:02.789+08:00",
      "archived_at": null,
      "workspace_id": "ws_xxx"
    },
    {
      "id": "agent_xxx",
      "type": "agent",
      "version": 1,
      "name": "data-analyst",
      "description": "数据分析助手",
      "model": {
        "id": "qwen3-max"
      },
      "system": "你是数据分析专家,使用 pandas 处理 CSV 文件。",
      "tools": [],
      "mcp_servers": [],
      "skills": [],
      "multiagent": {
        "type": "coordinator",
        "agents": [
          {
            "type": "self"
          }
        ]
      },
      "metadata": {
        "team": "data"
      },
      "created_at": "2026-05-28T16:23:11.456+08:00",
      "updated_at": "2026-05-28T16:23:11.456+08:00",
      "archived_at": null,
      "workspace_id": "ws_xxx"
    }
  ],
  "next_page": null,
  "request_id": "req_xxx"
}

Authorizations

string
header
required

DashScope API Key

Path Parameters

string
required

Query Parameters

integer

单页条数,默认 20,最大 100

string

分页游标。首次不传,后续传上一次响应的 next_page 翻下一页

Response

200-application/json
object[]

Agent 对象数组,每项为一个历史版本快照,按版本号倒序排列

string | null

下一页游标,无更多数据时为 null

string

本次请求的唯一标识

Overview
Managed Agent API
Sandbox API
Memory API
Flow Agent API
RAG API
Connector API
Framework Integration
Assistant API (Deprecating)
  • Overview