删除 Skill

路径

DELETE /api/v1/forward/skills/{id}

头部	必选	说明
`Authorization`	是	`Bearer <PAT 或 SAT>`

删除前会执行 Template 引用检查。无引用时删除 Skill；删除后不再出现在默认列表中。

参数	类型	必选	说明
`id`	string	是	Skill ID。

参数	类型	必选	说明
`identity_id`	string	否	仅在操作 Identity 归属资源时使用；PAT 可通过 Query 显式传入，不传时为管理员视角；SAT 由凭证确定归属，任何 SAT 显式携带该参数（包括空值）返回 HTTP 400。详见 Identity 归属。

curl -X DELETE "https://api.qoder.com/api/v1/forward/skills/skill_xxx" \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN"

{
  "id": "skill_xxx",
  "type": "skill_deleted",
  "deleted": true
}

HTTP	type	触发条件
400	`invalid_request_error`	请求体、路径参数或查询参数非法；包括 SAT 显式携带 Query `identity_id`（含空值）。
401	`authentication_error`	缺少或无效的认证令牌。
403	`permission_error`	管理员 Scope 发生 Owner mismatch，或下游服务拒绝访问。
404	`not_found_error`	Skill 不存在、未注册或在当前 Identity Scope 不可见；PAT 指定的 Identity 无效、已禁用、已删除或越权。
409	`conflict_error`	幂等键冲突、创建恢复需要人工介入，或删除时仍被引用。
429	`rate_limit_error`	上传容量不足。
500/502/503	`api_error`	Forward 或依赖服务失败。