删除智能体

删除当前工作区中的智能体。删除动作与该智能体的资源所有权清理在同一事务中完成；成功响应中的 data.deleted 为 true 时，删除已完成。

DELETE https://api.moi.matrixorigin.cn/v5/workspaces/{workspace_id}/agents/{agent_id}

调用前准备

先查询智能体详情，确认要删除的智能体。准备有目标工作区访问权限的个人访问令牌、目标工作区 ID 和智能体 ID。

请求参数

curl -X DELETE "https://api.moi.matrixorigin.cn/v5/workspaces/$WORKSPACE_ID/agents/$AGENT_ID" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID"

字段

类型

必填

说明

workspace_id

string

是

当前工作区 ID，必须与 X-Workspace-ID 一致。

agent_id

string

是

要删除的智能体 ID。

成功响应

{
  "code": 0,
  "data": {
    "deleted": true
  }
}

成功时返回 200。删除不可逆。

字段

类型

说明

code

integer

成功时为 0。

字段

类型

说明

data.deleted

boolean

为 true 表示智能体与资源所有权清理已完成。

错误响应

{
  "code": 3,
  "message": "agent not found"
}

字段

类型

说明

400

2（INVALID_ARGUMENT）

路径参数无效。建议：检查工作区 ID 和智能体 ID。

401

6（UNAUTHENTICATED）

缺少有效身份凭据。建议：检查 API Key。

403

5（PERMISSION_DENIED）

当前身份没有删除权限，或目标为只读资源。建议：使用有权限的身份；系统共享智能体不可通过此接口删除。

404

3（NOT_FOUND）

当前工作区中不存在该智能体。建议：检查智能体 ID，或先查询智能体列表。

503

15（UNAVAILABLE）

智能体资源服务或其授权依赖暂不可用。建议：稍后重试。

后续操作

删除后使用查询智能体列表确认该智能体不再出现。

最后更新于