Skip to main content
Versions

删除 Skill 版本

删除指定的 Skill 版本。

DELETE /api/v1/cloud/skills/{skill_id}/versions/{version} 删除指定的 Skill 版本并返回删除确认。

请求头

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

路径参数

参数类型必选说明
skill_idstringSkill 的唯一标识符
versionstring版本号,仅接受数字时间戳(规则同 获取 Skill 版本

示例请求

curl -X DELETE "https://api.qoder.com/api/v1/cloud/skills/skill_019e3bba474b73cfaf19eae9b5f5e66d/versions/1759264410332875" \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN"

示例响应

HTTP 200 OK
{
  "id": "1759264410332875",
  "type": "skill_version_deleted"
}
id 为被删除的版本号,删除成功通过 "type": "skill_version_deleted" 标识。

行为说明

  • 删除的是最新版本时,latest_version 自动回退到次新版本;所有版本删光后为 null
  • 对同一版本重复删除返回 404

错误码

HTTPtype触发条件
400invalid_request_error版本号非数字(含 latest
401authentication_error缺少或无效的认证令牌
404not_found_errorSkill 不存在,或该版本不存在 / 已被删除(重复删除同样返回 404)
完整错误信封说明详见 错误参考

相关