---
title: "List skill versions"
method: GET
path: "/v1alpha/skills/{skill_id}/versions"
tags: ["Skills"]
---

# List skill versions

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

List all versions of a skill.

## Path parameters

- `skill_id` string, required

## Query parameters

- `after` string, nullable — Cursor for pagination
- `limit` integer — Maximum number of results
- `order` 'asc' | 'desc' — Sort order by version

## Response `200`

Successful Response

- ListSkillVersionsResponse — Response from listing skill versions.
  - `object` 'list'
  - `data` SkillVersion[], required — List of skill version objects
    - `id` string, required — Unique identifier for this version
    - `created_at` integer, required — Unix timestamp when this version was created
    - `description` string, required — Description of the skill version
    - `name` string, required — Name of the skill version
    - `object` 'skill.version'
    - `skill_id` string, required — ID of the parent skill
    - `version` string, required — Version number as a string
  - `has_more` boolean — Whether there are more results
  - `first_id` string, nullable — ID of the first item in the list
  - `last_id` string, nullable — ID of the last item in the list

## Other responses

- `400` — The request was invalid or malformed
- `429` — The client has sent too many requests in a given amount of time
- `500` — The server encountered an unexpected error
- `default` — An error occurred

---

[API](https://skmtc.net/ogx-ai/apis/ogx-specification-stable-experimental-apis.md) · [All operations](https://skmtc.net/ogx-ai/apis/ogx-specification-stable-experimental-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ogx-ai/ogx-specification-stable-experimental-apis/revisions/f3f783962256/schema)