删除指定的 Skill 版本。
DELETE /api/v1/cloud/skills/{skill_id}/versions/{version}
删除指定的 Skill 版本并返回删除确认。
请求头
| 头部 | 必选 | 说明 |
|---|---|---|
Authorization | 是 | Bearer <PAT 或 SAT> |
路径参数
| 参数 | 类型 | 必选 | 说明 |
|---|---|---|---|
skill_id | string | 是 | Skill 的唯一标识符 |
version | string | 是 | 版本号,仅接受数字时间戳(规则同 获取 Skill 版本) |
示例请求
示例响应
HTTP 200 OK
id 为被删除的版本号,删除成功通过 "type": "skill_version_deleted" 标识。
行为说明
- 删除的是最新版本时,
latest_version自动回退到次新版本;所有版本删光后为null - 对同一版本重复删除返回 404
错误码
| HTTP | type | 触发条件 |
|---|---|---|
| 400 | invalid_request_error | 版本号非数字(含 latest) |
| 401 | authentication_error | 缺少或无效的认证令牌 |
| 404 | not_found_error | Skill 不存在,或该版本不存在 / 已被删除(重复删除同样返回 404) |