メインコンテンツへスキップ
GET /v1/skills/{skill_id}/versions 指定された Skill の現在のバージョン情報を data 配列として返します。

​
パスパラメータ

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

​
ヘッダー

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

​
リクエスト例

curl -X GET https://api.qoder.com/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"
    }
  ]
}

​
レスポンスフィールド

フィールド型説明
dataarraySkill バージョンオブジェクトの配列

​
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" など）
  • 現在の実装では、アクティブな Skill の現在のバージョン情報を返します
  • PUT /v1/skills/{skill_id} で content を更新するとバージョン番号がインクリメントされます
  • メタデータのみの更新ではバージョンはインクリメントされません

​
関連項目

Agent スキル

Agent にドメインの専門知識を付与する。