删除技能¶
删除技能及其版本和文件记录。删除前须核对引用,解绑和停用是不同操作。
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"
参数 |
类型 |
是否必填 |
说明 |
|---|---|---|---|
|
string |
是 |
当前环境的目标工作区ID,与请求头一致。 |
|
string |
是 |
当前环境的工作区ID。 |
|
string |
是 |
当前环境的个人访问令牌。 |
|
string |
是 |
待删除的当前工作区技能ID。 |
|
string |
否 |
查询参数;省略为当前工作区。system来源只读;不能借此删除其他工作区对象。 |
此动作不接收预期版本或强制级联字段。仍被引用时先核对相应资源的引用列表,再按实际意图解绑;不要自动解绑其他智能体。422在本地化成功时带details.reason=SKILL_IN_USE和domain;工具删除使用不同的TOOL_IN_USE。
成功响应¶
{
"code": 0,
"data": {
"deleted": true
}
}
字段 |
类型 |
说明 |
|---|---|---|
|
integer |
成功为0。 |
|
boolean |
删除成功为true。 |
错误响应¶
HTTP / code |
条件与处理 |
|---|---|
400 / 2 |
对象或工作区标识无效。 |
403 / 5 |
目标为系统来源或当前授权拒绝。 |
404 / 3 |
目标不存在;重复删除不保证再次成功。 |
422 / 2 |
仍有智能体定义或工作区覆盖中的有效绑定引用;先处理引用。 |
503 / 15 |
资源或授权依赖不可用。 |
500 / 1 |
引用阻止删除时,本地化消息处理失败。 |
认证阶段还可返回字符串code/msg;具体说明见错误与环境。
最后更新于