指定した Skill バージョンを削除する。
DELETE /api/v1/cloud/skills/{skill_id}/versions/{version}
指定した Skill バージョンを削除し、削除確認を返します。
ヘッダー
| ヘッダー | 必須 | 説明 |
|---|---|---|
Authorization | はい | Bearer <PAT or 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 | TOKEN_INVALID | 認証トークンが欠落または無効 |
| 404 | not_found_error | Skill が存在しない、またはバージョンが存在しない / すでに削除されている（再削除も 404） |