删除技能

删除技能及其版本和文件记录。删除前须核对引用,解绑和停用是不同操作。

DELETE https://api.moi.matrixorigin.cn/v5/workspaces/{workspace_id}/skills/{skill_id}

调用前准备

按AI Studio取得当前环境的个人访问令牌和工作区ID。当前有效角色须获准执行相应操作。从当前工作区资源列表取得确切ID,并先核对引用智能体。

请求参数

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

参数

类型

是否必填

说明

workspace_id

string

是

当前环境的目标工作区ID,与请求头一致。

X-Workspace-ID

string

是

当前环境的工作区ID。

X-API-Key

string

是

当前环境的个人访问令牌。

skill_id

string

是

待删除的当前工作区技能ID。

skill_workspace_id

string

否

查询参数;省略为当前工作区。system来源只读;不能借此删除其他工作区对象。

此动作不接收预期版本或强制级联字段。仍被引用时先核对相应资源的引用列表,再按实际意图解绑;不要自动解绑其他智能体。422在本地化成功时带details.reason=SKILL_IN_USE和domain;工具删除使用不同的TOOL_IN_USE。

成功响应

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

字段

类型

说明

code

integer

成功为0。

data.deleted

boolean

删除成功为true。

错误响应

HTTP / code

条件与处理

400 / 2

对象或工作区标识无效。

403 / 5

目标为系统来源或当前授权拒绝。

404 / 3

目标不存在;重复删除不保证再次成功。

422 / 2

仍有智能体定义或工作区覆盖中的有效绑定引用;先处理引用。

503 / 15

资源或授权依赖不可用。

500 / 1

引用阻止删除时,本地化消息处理失败。

认证阶段还可返回字符串code/msg;具体说明见错误与环境。

最后更新于