删除 Skill 版本

描述

软删除指定 Skill 的一个版本。删除后该版本不再出现在版本列表中；如果删除的是最新版本，latest_version 会自动指向次新的 active 版本，或在无剩余版本时变为 null。

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

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

参数	类型	必选	说明
`id`	string	是	Skill ID。
`version`	string	是	版本号；接受 16 位 Unix 微秒时间戳或过渡期的老递增计数器。字面量 `latest` 不受支持，返回 400。详见老版本编号兼容。

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

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

HTTP 200 OK

{
  "id": "1786973491821648",
  "type": "skill_version_deleted",
  "deleted": true
}

如果被删除的版本是该 Skill 的 latest_version，服务端会自动将 latest_version 指向剩余活跃版本中 created_at 最新的那个。
如果删除后无剩余活跃版本，latest_version 变为 null。
删除是软删除，被删版本的 status 变为 deleted，存储实体不立即销毁。

HTTP	type	触发条件
400	`invalid_request_error`	版本号格式非法（例如传入 `latest` 或非数字字符串），或 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`	资源状态冲突（如 Skill 已归档）。
500/502/503	`api_error`	Forward 或依赖服务失败。