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

以 `data` 数组形式返回指定 Skill 当前存储版本的描述信息。

## 请求头

| 头部              | 必选 | 说明             |
| --------------- | -- | -------------- |
| `Authorization` | 是  | `Bearer <PAT>` |

## 路径参数

| 参数         | 类型     | 必选 | 说明           |
| ---------- | ------ | -- | ------------ |
| `skill_id` | string | 是  | Skill 的唯一标识符 |

## 示例请求

```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 version 对象](/zh/cloud-agents/api/skills/schemas#skill-version-对象)数组 |

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  | `authentication_error` | 缺少或无效的认证令牌      |
| 404  | `not_found_error`      | Skill 不存在或不再可访问 |

## 注意事项

* 版本号以字符串形式返回（如 `"1"`）
* 当前实现返回 active Skill 的当前版本描述
* 通过 `PUT /api/v1/cloud/skills/{skill_id}` 更新 `content` 时版本号递增
* 仅更新元数据时版本号不会递增

完整错误信封说明详见 [错误参考](/zh/cloud-agents/api/conventions/errors)。

## 相关

<CardGroup cols={2}>
  <Card title="Agent 技能" icon="sparkles" href="/zh/cloud-agents/skills">
    为 Agent 附加领域专业知识。
  </Card>
</CardGroup>