AI 助理
文档备案控制台
官方文档
输入文档关键字查找
首页

删除 Agent

更新时间：
复制为 MD 格式
产品详情
我的收藏

永久删除指定的 Agent。此操作不可逆。

请求头

头部

必选

说明

Authorization

是

Bearer

路径参数

参数

类型

必选

说明

agent_id

string

是

Agent 唯一标识

请求体

无需请求体。

示例请求

curl -X DELETE "https://api.qoder.com.cn/api/v1/cloud/agents/agent_019eXXXX..." \
  -H "Authorization: Bearer $QODER_PAT"

示例响应

HTTP 200 OK

{
  "type": "agent",
  "id": "agent_019eXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
  "deleted": true
}

响应字段

字段

类型

说明

type

string

固定值 "agent"

id

string

被删除的 Agent 唯一标识

deleted

boolean

固定值 true，表示删除成功

错误码

HTTP

type

触发条件

401

authentication_error

PAT 无效或过期

403

permission_error

无权限删除此 Agent（可能需要 admin 角色）

404

not_found_error

指定 ID 的 Agent 不存在或已被删除

注意事项

  • 删除操作是永久性的，不可恢复

  • 如果只是想暂时停用 Agent，建议使用 归档

  • 删除已归档的 Agent 也是允许的

  • 删除后再次对同一 ID 调用 DELETE 会返回 404

  • 在某些部署环境中，删除操作可能需要额外的管理员权限（x-gw-roles: admin 头），此时无权限会返回 403

删除前建议

  1. 确认 Agent 当前没有活跃的 Session 在运行

  2. 如果不确定是否需要永久删除，优先使用归档操作

  3. 删除前可通过版本历史端点备份 Agent 配置信息

上一篇：归档 Agent下一篇：列出 Agent 版本