既存の Skill に新しい不変のバージョンスナップショットをアップロードする。
POST /api/v1/cloud/skills/{skill_id}/versions
既存の Skill に新しいバージョンを追加します。各バージョンは差分ではなく、完全なコンテンツスナップショットです。multipart/form-data エンコーディングと files フィールドを使用します。形式と検証ルールは Skill の作成 と同じです。
ヘッダー
| ヘッダー | 必須 | 説明 |
|---|---|---|
Authorization | はい | Bearer <PAT or SAT> |
Content-Type | いいえ | curl -F により multipart/form-data が自動設定されるため、手動で指定する必要はありません |
パスパラメーター
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
skill_id | string | はい | Skill の一意識別子 |
リクエストボディ（multipart/form-data）
| フィールド | 型 | 必須 | 説明 |
|---|---|---|---|
files | file（繰り返し可） | はい | 新バージョンの完全な内容。単一の .zip アーカイブまたはベアファイルツリー。パッケージルールは Skill パッケージ を参照してください |
リクエスト例
レスポンス例
HTTP 201 Created
レスポンスフィールド
レスポンスは Skill バージョンオブジェクト です。
| フィールド | 型 | 説明 |
|---|---|---|
id | string | バージョンの一意識別子 |
type | string | 常に "skill_version" |
skill_id | string | 所属する Skill の ID |
version | string | バージョン識別子 |
name | string | このバージョンの SKILL.md frontmatter にある name |
description | string | このバージョンの SKILL.md frontmatter にある description |
directory | string | Skill ディレクトリ名 |
created_at | string | バージョン作成時刻 |
エラーレスポンス
| HTTP | type | 説明 |
|---|---|---|
| 400 | invalid_request_error | パッケージ構造が無効、SKILL.md がない、frontmatter が無効、または展開後の内容が 50 MB を超えている |
| 400 | invalid_request_error | 新バージョンの name が既存の Skill の name と一致しない |
| 401 | TOKEN_INVALID | 認証トークンが欠落または無効 |
| 404 | not_found_error | Skill が存在しない、または削除されている |
| 413 | request_too_large_error | アーカイブが 50 MB を超えている |
| 429 | rate_limit_error | レート制限またはクォータ制限に達した |
注意事項
- 新しいバージョンの作成後、Skill の
latest_versionはそのバージョンを指し、updated_atが更新されます。