Skip to main content
Versions

Skill バージョン一覧

指定した Skill のすべてのバージョンを、バージョン番号の降順でページネーション付きで返す。

GET /api/v1/cloud/skills/{skill_id}/versions 指定した Skill のすべてのバージョンを、version の降順(最新のバージョンが先頭)でページネーション付きで返します。

ヘッダー

| ヘッダー | 必須 | 説明 | | --- | --- | --- | --- | | Authorization | はい | Bearer <PAT or SAT> |

パスパラメータ

パラメータ必須説明
skill_idstringはいSkill の一意識別子

クエリパラメーター

| パラメーター | 型 | 必須 | 説明 | | --- | --- | --- | | limit | integer | いいえ | 1 ページあたりの最大件数。デフォルト 20、最大 1000 | | page | string | いいえ | 次方向のページングカーソル。前ページのレスポンスにある next_page の値を使用 |

リクエスト例

curl -X GET "https://api.qoder.com/api/v1/cloud/skills/skill_019e3bba474b73cfaf19eae9b5f5e66d/versions?limit=20" \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN"

レスポンス例

HTTP 200 OK
{
  "data": [
    {
      "id": "skillver_019e3bbb6a25768b9b50ca2f52aa4345",
      "type": "skill_version",
      "skill_id": "skill_019e3bba474b73cfaf19eae9b5f5e66d",
      "version": "1759264410332875",
      "name": "my-custom-skill",
      "description": "Custom skill example (second revision)",
      "directory": "my-custom-skill",
      "created_at": "2026-05-19T10:12:07.332875Z"
    },
    {
      "id": "skillver_019e3bba474b7f10a3c2b4d5e6f70123",
      "type": "skill_version",
      "skill_id": "skill_019e3bba474b73cfaf19eae9b5f5e66d",
      "version": "1759178010641129",
      "name": "my-custom-skill",
      "description": "Custom skill example",
      "directory": "my-custom-skill",
      "created_at": "2026-05-18T15:35:24.248164Z"
    }
  ],
  "has_more": false,
  "next_page": null
}

レスポンスフィールド

フィールド説明
dataarraySkill バージョンオブジェクトの配列。version の降順
has_morebooleanさらにレコードがあるかどうか。true の場合は next_page を次ページの page 値として使用
next_pagestring | null次ページのカーソル。has_moretrue の場合は page に渡す

SkillVersion オブジェクト

フィールド説明
idstringバージョンの一意識別子
typestring常に "skill_version"
skill_idstring所属する Skill の ID
versionstringバージョン識別子
namestringこのバージョンの SKILL.md frontmatter にある name
descriptionstringこのバージョンの SKILL.md frontmatter にある description
directorystringSkill ディレクトリ名
created_atstringバージョン作成時刻
content_sizeinteger⚠️ 非推奨:このバージョンの zip ファイルサイズ(バイト)(代替なし。今後削除予定)
content_sha256string⚠️ 非推奨:このバージョン内容の SHA-256 ハッシュ(代替なし。今後削除予定)
statusstring⚠️ 非推奨:バージョン状態 active(代替なし。今後削除予定)
updated_atstring⚠️ 非推奨:バージョンの最終更新時刻(バージョンは不変のため、代わりに created_at を使用)

エラーレスポンス

HTTPtype説明
401TOKEN_INVALID認証トークンが欠落または無効
404not_found_errorSkill が存在しないまたはアクセス不可

注意事項

完全なエラーエンベロープについては エラー を参照してください。

関連項目