メインコンテンツへスキップ

Documentation Index

Fetch the complete documentation index at: https://docs.qoder.com/llms.txt

Use this file to discover all available pages before exploring further.

GET /v1/skills/{skill_id}/versions 指定された Skill のすべての履歴バージョン一覧を取得します。

パスパラメータ

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

ヘッダー

ヘッダー必須説明
AuthorizationはいBearer $QODER_PAT

リクエスト例

curl -X GET https://openapi.qoder.sh/api/v1/cloud/skills/skill_019e3bba474b73cfaf19eae9b5f5e66d/versions \
  -H "Authorization: Bearer $QODER_PAT"

レスポンス例

HTTP 200 OK
{
  "data": [
    {
      "version": "1",
      "skill_id": "skill_019e3bba474b73cfaf19eae9b5f5e66d",
      "status": "active",
      "content_size": 309,
      "content_sha256": "f253cb7d35790025f85917c0c239422cff1de067d00278db8897c585a3f28d94",
      "created_at": "2026-05-18T15:35:24.248164Z",
      "updated_at": "2026-05-18T15:36:01.767469Z"
    }
  ]
}

レスポンスフィールド

フィールド説明
dataarraySkillVersion オブジェクト配列

SkillVersion オブジェクト

フィールド説明
versionstringバージョン番号(文字列形式、"1""2" など)
skill_idstring所属する Skill の ID
statusstringバージョン状態:active
content_sizeintegerこのバージョンの zip ファイルサイズ(バイト)
content_sha256stringこのバージョン内容の SHA-256 ハッシュ値
created_atstringバージョン作成時刻(ISO 8601)
updated_atstringバージョン最終更新時刻(ISO 8601)

エラーレスポンス

HTTPtype説明
401TOKEN_INVALID認証トークンが欠落または無効
404not_found_errorSkill が存在しないまたは削除済み

注意事項

  • バージョン番号は文字列形式で返されます("1" など)
  • バージョン一覧は作成時刻順で並びます
  • POST /v1/skills で新しいファイルをアップロードするたびに、バージョン番号がインクリメントされます
  • PUT によるメタデータ更新では新しいバージョンは生成されません