Skip to main content
Versions

删除 Skill 版本

Forward Skill 版本 API 接口说明。

描述

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

路径

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

请求头

头部必选说明
AuthorizationBearer <PAT 或 SAT>

路径参数

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

示例请求

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
}

响应字段

字段类型说明
idstring被删除的版本号。
typestring固定值 "skill_version_deleted"
deletedboolean固定值 true

副作用

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

错误码

HTTPtype触发条件
400invalid_request_error版本号格式非法(例如传入 latest 或非数字字符串)。
401authentication_error缺少或无效的认证令牌。
403permission_error当前调用方无权访问该 Skill。
404not_found_errorSkill 或版本不存在。
409conflict_error资源状态冲突(如 Skill 已归档)。
500/502/503api_errorForward 或依赖服务失败。