> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hitheo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 技能版本

> 獲取已發佈技能的版本歷史。

獲取已發佈技能的版本歷史，包括清單快照和變更日誌。

## 身份驗證

需要 Bearer 令牌。參見[身份驗證](/api-reference/authentication)。

## 路徑參數

<ParamField path="id" type="string" required>
  技能 UUID。
</ParamField>

## 請求示例

<CodeGroup>
  ```bash curl theme={null}
  curl https://www.hitheo.ai/api/v1/skills/skill_abc123/versions \
    -H "Authorization: Bearer $THEO_API_KEY"
  ```

  ```typescript SDK theme={null}
  const versions = await theo.skillVersions("skill_abc123");
  ```
</CodeGroup>

## 響應

<ResponseField name="versions" type="object[]">
  版本記錄數組。

  <Expandable title="Version object">
    <ResponseField name="id" type="string">版本記錄 ID。</ResponseField>
    <ResponseField name="version" type="string">語義化版本字符串。</ResponseField>
    <ResponseField name="status" type="string">`"active"`（生效中）、`"superseded"`（已被取代）或 `"withdrawn"`（已撤回）。</ResponseField>
    <ResponseField name="changelog" type="string | null">該版本的 Markdown 格式變更日誌。</ResponseField>
    <ResponseField name="manifestSnapshot" type="object">發佈時的完整清單。</ResponseField>
    <ResponseField name="createdAt" type="string">ISO 8601 時間戳。</ResponseField>
  </Expandable>
</ResponseField>

## 端點

`GET /api/v1/skills/{id}/versions`

需要通過 Bearer 令牌進行身份驗證。參見[身份驗證](/api-reference/authentication)。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.