Documentation Index
Fetch the complete documentation index at: https://docs.qoder.com/llms.txt
Use this file to discover all available pages before exploring further.
DELETE /v1/agents/{agent_id}
永久删除指定的 Agent。此操作不可逆。
请求头
| 头部 | 必选 | 说明 |
|---|
Authorization | 是 | Bearer <PAT> |
路径参数
| 参数 | 类型 | 必选 | 说明 |
|---|
agent_id | string | 是 | Agent 唯一标识 |
请求体
无需请求体。
示例请求
curl -X DELETE "https://openapi.qoder.sh/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
删除前建议
- 确认 Agent 当前没有活跃的 Session 在运行
- 如果不确定是否需要永久删除，优先使用归档操作
- 删除前可通过版本历史端点备份 Agent 配置信息
