Forward Skill 版本 API 接口说明。
描述
软删除指定 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。详见 老版本编号兼容。 |
示例请求
示例响应
HTTP 200 OK
响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
id | string | 被删除的版本号。 |
type | string | 固定值 "skill_version_deleted" |
deleted | boolean | 固定值 true |
副作用
- 如果被删除的版本是该 Skill 的
latest_version,服务端会自动将latest_version指向剩余活跃版本中created_at最新的那个。 - 如果删除后无剩余活跃版本,
latest_version变为null。 - 删除是软删除,被删版本的
status变为deleted,存储实体不立即销毁。
错误码
| HTTP | type | 触发条件 |
|---|---|---|
| 400 | invalid_request_error | 版本号格式非法(例如传入 latest 或非数字字符串)。 |
| 401 | authentication_error | 缺少或无效的认证令牌。 |
| 403 | permission_error | 当前调用方无权访问该 Skill。 |
| 404 | not_found_error | Skill 或版本不存在。 |
| 409 | conflict_error | 资源状态冲突(如 Skill 已归档)。 |
| 500/502/503 | api_error | Forward 或依赖服务失败。 |