# 删除技能

```{raw} html
<div class="mo-api-page-show-toc" aria-hidden="true"></div>
```

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

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

## 调用前准备

按[AI Studio](../../../../../developer/api/ai-studio/index.md)取得当前环境的个人访问令牌和工作区ID。当前有效角色须获准执行相应操作。从当前工作区资源列表取得确切ID，并先核对引用智能体。

## 请求参数

:::::::{div} mo-api-tabs
::::::{tab-set}
:::::{tab-item} 输入示例

```bash
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"
```

:::::
:::::{tab-item} 参数说明

| 参数 | 类型 | 是否必填 | 说明 |
| --- | --- | --- | --- |
| `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。

:::::
::::::
:::::::

## 成功响应

:::::::{div} mo-api-tabs mo-api-response-tabs
::::::{tab-set}
:::::{tab-item} 响应示例

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

:::::
:::::{tab-item} 字段说明

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `code` | integer | 成功为0。 |
| `data.deleted` | boolean | 删除成功为true。 |

:::::
::::::
:::::::

## 错误响应

| HTTP / code | 条件与处理 |
| --- | --- |
| 400 / 2 | 对象或工作区标识无效。 |
| 403 / 5 | 目标为系统来源或当前授权拒绝。 |
| 404 / 3 | 目标不存在；重复删除不保证再次成功。 |
| 422 / 2 | 仍有智能体定义或工作区覆盖中的有效绑定引用；先处理引用。 |
| 503 / 15 | 资源或授权依赖不可用。 |
| 500 / 1 | 引用阻止删除时，本地化消息处理失败。 |

认证阶段还可返回字符串code/msg；具体说明见[错误与环境](errors-environments.md)。
