Repository Public
1---2title: List Skill Versions3url: https://platform.claude.com/docs/en/api/skills/versions/list4---56# List Skill Versions78**GET** `/v1/skills/{skill_id}/versions`910List Skill Versions1112## Path parameters1314- `skill_id: string`1516 Unique identifier for the skill.1718 The format and length of IDs may change over time.1920## Query parameters2122- `limit: optional number`2324 Number of results to return per page.2526 Ranges from `1` to `1000`. Defaults to `20`.2728 default: 20, minimum: 1, maximum: 10002930- `page: optional string`3132 Optionally set to the `next_page` token from the previous response.3334## Headers3536- `"anthropic-workspace-id": optional string`3738## Returns3940- `data: array of SkillVersion`4142 List of skills.4344 - `type: "skill_version"`4546 Object type.4748 For Skill Versions, this is always `"skill_version"`.4950 default: skill_version5152 - `id: string`5354 Unique identifier for this Skill Version. The id addresses the version in55 paths and pins it in references.5657 - `created_at: string`5859 ISO 8601 timestamp of when the skill was created.6061 format: date-time6263 - `description: string`6465 Description of the skill version.6667 This is extracted from the SKILL.md file in the skill upload.6869 - `name: string`7071 The Skill's immutable kebab-case slug, set at creation from the first72 upload's SKILL.md frontmatter `name` (or its enclosing directory). Every73 later upload must resolve to the same value. Also the top-level directory74 of the Skill's mounted files and the base name of a downloaded archive.7576 - `skill_id: string`7778 Unique identifier for the skill.7980 The format and length of IDs may change over time.8182- `next_page: string or null`8384 Token for fetching the next page of results.8586 If `null`, there are no more results available. Pass this value to the `page` parameter in the next request to get the next page.8788## Example8990```bash91curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions \92 -H 'anthropic-version: 2023-06-01' \93 -H "X-Api-Key: $ANTHROPIC_API_KEY"94```9596### Response (200)9798```json99{100 "data": [101 {102 "id": "id",103 "created_at": "2024-10-30T23:58:27.427722Z",104 "description": "description",105 "name": "name",106 "skill_id": "skill_01JAbcdefghijklmnopqrstuvw",107 "type": "skill_version"108 }109 ],110 "next_page": "next_page"111}112```113