删除智能体版本

删除一个已停用且非默认的版本。删除后无法恢复该版本。

DELETE https://moi.matrixorigin.cn/newmoi/workspaces/{workspace_id}/agents/{agent_id}/versions/{version}

调用前准备

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

只能删除已停用且非默认的版本。

请求参数

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

字段

类型

必填

说明

workspace_id

string

是

当前工作区 ID。

agent_id

string

是

智能体 ID。

version

string

是

要删除的版本号。

成功响应

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

成功时返回 200。data.deleted 为 true 时，版本已删除。

字段

类型

说明

code

integer

成功时为 0。

字段

类型

说明

data.deleted

boolean

为 true 时，指定版本已被删除。

错误响应

{
  "code": 2,
  "message": "<错误信息>"
}

字段

类型

说明

400

2（INVALID_ARGUMENT）

路径参数无效，或版本仍是默认版本、尚未停用。建议：先将其他可运行版本设为默认版本，再停用目标版本。

401

6（UNAUTHENTICATED）

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

403

5（PERMISSION_DENIED）

当前调用者没有更新智能体的权限。建议：检查工作区中的智能体授权。

404

3（NOT_FOUND）

智能体或版本不存在。建议：先查询版本列表。

503

15（UNAVAILABLE）

版本服务、操作记录服务或授权依赖暂不可用。建议：稍后重试。

后续操作

查询智能体版本，确认目标已不再出现。

最后更新于