指定した Skill のすべてのバージョンを、バージョン番号の降順でページネーション付きで返す。
GET /api/v1/cloud/skills/{skill_id}/versions
指定した Skill のすべてのバージョンを、version の降順(最新のバージョンが先頭)でページネーション付きで返します。
ヘッダー
| ヘッダー | 必須 | 説明 |
| --- | --- | --- | --- |
| Authorization | はい | Bearer <PAT or SAT> |
パスパラメータ
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
skill_id | string | はい | Skill の一意識別子 |
クエリパラメーター
| パラメーター | 型 | 必須 | 説明 |
| --- | --- | --- |
| limit | integer | いいえ | 1 ページあたりの最大件数。デフォルト 20、最大 1000 |
| page | string | いいえ | 次方向のページングカーソル。前ページのレスポンスにある next_page の値を使用 |
リクエスト例
レスポンス例
HTTP 200 OK
レスポンスフィールド
| フィールド | 型 | 説明 |
|---|---|---|
data | array | Skill バージョンオブジェクトの配列。version の降順 |
has_more | boolean | さらにレコードがあるかどうか。true の場合は next_page を次ページの page 値として使用 |
next_page | string | null | 次ページのカーソル。has_more が true の場合は page に渡す |
SkillVersion オブジェクト
| フィールド | 型 | 説明 |
|---|---|---|
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 | バージョン作成時刻 |
content_size | integer | ⚠️ 非推奨:このバージョンの zip ファイルサイズ(バイト)(代替なし。今後削除予定) |
content_sha256 | string | ⚠️ 非推奨:このバージョン内容の SHA-256 ハッシュ(代替なし。今後削除予定) |
status | string | ⚠️ 非推奨:バージョン状態 active(代替なし。今後削除予定) |
updated_at | string | ⚠️ 非推奨:バージョンの最終更新時刻(バージョンは不変のため、代わりに created_at を使用) |
エラーレスポンス
| HTTP | type | 説明 |
|---|---|---|
| 401 | TOKEN_INVALID | 認証トークンが欠落または無効 |
| 404 | not_found_error | Skill が存在しないまたはアクセス不可 |
注意事項
- 各バージョンは不変の完全なコンテンツスナップショットです。Skill バージョンの作成 で追加します。