---
title: "List Skill Versions"
method: GET
path: "/v1/skills/{skill_id}/versions"
tags: ["Skills"]
---

# List Skill Versions

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

List versions for a skill with cursor pagination.

## Path parameters

- `skill_id` string, required

## Query parameters

- `collection` string, required
- `limit` integer
- `page` string, nullable

## Headers

- `anthropic-beta` string[], nullable

## Response `200`

Paginated list of skill versions.

- ListSkillVersionsResponse — Paginated list response containing skill version objects.
  - `data` SkillVersionResponse[] — Skill version page data.
    - `id` string, required — Unique skill version identifier.
    - `created_at` string, date-time, required — Creation timestamp.
    - `description` string, required — Skill version description from frontmatter.
    - `directory` string, required — Top-level directory name for this version.
    - `name` string, required — Skill name from frontmatter.
    - `skill_id` string, required — Parent skill identifier.
    - `type` 'skill_version' — Object type.
    - `version` string, required — Version token.
  - `has_more` boolean, required — Whether there is a next page.
  - `next_page` string, nullable — Token for next page.

## Other responses

- `401` — Unauthorized
- `422` — Validation Error

## Changes

- **2026-06-02** `c711b911f68e` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/zylon-ai/apis/private-gpt-api/changes/v1/skills/:skill_id/versions/get.md)

---

[API](https://skmtc.dev/zylon-ai/apis/private-gpt-api.md) · [All operations](https://skmtc.dev/zylon-ai/apis/private-gpt-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zylon-ai/private-gpt-api/revisions/4e828cf153c4/schema)