> ## 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.

# Skill バージョン一覧

> 指定の Skill の現在のバージョン情報を返します。

`GET /api/v1/cloud/skills/{skill_id}/versions`

指定された Skill の現在のバージョン情報を `data` 配列として返します。

## パスパラメータ

| パラメータ      | 型      | 必須 | 説明           |
| ---------- | ------ | -- | ------------ |
| `skill_id` | string | はい | Skill の一意識別子 |

## ヘッダー

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

## リクエスト例

```bash theme={null}
curl -X GET https://api.qoder.com/api/v1/cloud/skills/skill_019e3bba474b73cfaf19eae9b5f5e66d/versions \
  -H "Authorization: Bearer $QODER_PAT"
```

## レスポンス例

**HTTP 200 OK**

```json theme={null}
{
  "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"
    }
  ]
}
```

## レスポンスフィールド

| フィールド  | 型     | 説明                                                                               |
| ------ | ----- | -------------------------------------------------------------------------------- |
| `data` | array | [Skill バージョンオブジェクト](/ja/cloud-agents/api/skills/schemas#skill-version-object)の配列 |

### SkillVersion オブジェクト

| フィールド            | 型       | 説明                            |
| ---------------- | ------- | ----------------------------- |
| `version`        | string  | バージョン番号（文字列形式、`"1"`、`"2"` など） |
| `skill_id`       | string  | 所属する Skill の ID               |
| `status`         | string  | バージョン状態：`active`              |
| `content_size`   | integer | このバージョンの zip ファイルサイズ（バイト）     |
| `content_sha256` | string  | このバージョン内容の SHA-256 ハッシュ値      |
| `created_at`     | string  | バージョン作成時刻（ISO 8601）           |
| `updated_at`     | string  | バージョン最終更新時刻（ISO 8601）         |

## エラーレスポンス

| HTTP | type              | 説明                    |
| ---- | ----------------- | --------------------- |
| 401  | `TOKEN_INVALID`   | 認証トークンが欠落または無効        |
| 404  | `not_found_error` | Skill が存在しないまたはアクセス不可 |

## 注意事項

* バージョン番号は文字列形式で返されます（`"1"` など）
* 現在の実装では、アクティブな Skill の現在のバージョン情報を返します
* `PUT /api/v1/cloud/skills/{skill_id}` で `content` を更新するとバージョン番号がインクリメントされます
* メタデータのみの更新ではバージョンはインクリメントされません

## 関連項目

<CardGroup cols={2}>
  <Card title="Agent スキル" icon="sparkles" href="/ja/cloud-agents/skills">
    Agent にドメインの専門知識を付与する。
  </Card>
</CardGroup>