文档中心

火山方舟

Agents

删除智能体

DELETE https://ark.cn-beijing.volces.com/api/v3/agents/{agent_id}

删除指定的智能体。删除后，无法再通过 API 查询或恢复该智能体及其历史版本。

存在 status 为 running（运行中）的关联 Session 时，删除请求返回 400 InvalidAction；其他状态的关联 Session 不阻止删除。

鉴权

本接口支持鉴权方式如下，详情请参见 Base URL 及鉴权。

请求参数

Path 参数

agent_id string 必选 | 智能体 ID

响应参数

id string | 智能体 ID

删除智能体

发起调试等同于请求真实调用，可能产生云产品费用，请谨慎操作！

Request

curl -sS --fail-with-body -X DELETE "https://ark.cn-beijing.volces.com/api/v3/agents/<AGENT_ID>" \
  -H "Authorization: Bearer $ARK_API_KEY"

Response

{
  "id": "<AGENT_ID>"
}

最近更新时间：2026.10.30 21:22:46

这个页面对您有帮助吗？

有用

无用