Agent

删除 Agent

永久删除指定的 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	`TOKEN_INVALID`	PAT 无效、缺失或格式错误
403	`permission_error`	无权限删除此 Agent（可能需要 admin 角色）
404	`not_found_error`	指定 ID 的 Agent 不存在或已被删除

注意事项

删除操作是永久性的，不可恢复
如果只是想暂时停用 Agent，建议使用归档
删除已归档的 Agent 也是允许的
删除后再次对同一 ID 调用 DELETE 会返回 404
在某些部署环境中，删除操作可能需要额外的管理员权限（x-gw-roles: admin 头），此时无权限会返回 403

删除前建议

确认 Agent 当前没有活跃的 Session 在运行
如果不确定是否需要永久删除，优先使用归档操作
删除前可通过版本历史端点备份 Agent 配置信息

本页目录

请求头
路径参数
请求体
示例请求
示例响应
响应字段
错误码
注意事项
删除前建议