归档智能体 API：POST /agents/{agent_id}/archive-大模型服务平台百炼(Model Studio)-阿里云帮助中心

软归档：智能体保留但默认不出现在列表中，且不可用于新建会话；已有会话不受影响。

前提

已完成 Endpoint 与鉴权配置，详见API 总览与认证。

POST /agents/{agent_id}/archive

软归档：响应返回完整 agent 对象，archived_at 字段被填入归档时间。归档后默认不出现在列表中（除非 include_archived=true），不可用于新建会话，已有会话不受影响。

Bash

curl -X POST "$AGENTSTUDIO_URL/agents/agent_xxx/archive" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY"

Python

client.agents.archive("agent_xxx")

Java

client.agents().archive("agent_xxx");

响应为 Agent 对象，结构同创建 Agent响应，唯一差异是 archived_at 字段被填入归档时间（不再为 null）。字段如下：

字段	类型	说明
`id`	string	智能体 ID
`type`	string	固定为 `agent`
`version`	int	当前版本号（归档不改变版本）
`name` / `description` / `system`	string	智能体名称、用途说明、系统提示词
`model` / `tools` / `mcp_servers` / `skills` / `metadata`	object / array	模型、工具包、MCP 引用、技能、业务元数据
`archived_at`	string	归档时间，ISO 8601；归档接口返回的对象中该字段一定非空
`created_at` / `updated_at`	string	创建/最近更新时间
`workspace_id`	string	所属工作空间 ID
`request_id`	string	本次请求的唯一标识