Repository Public
1---2title: Versions3url: https://platform.claude.com/docs/en/api/skills/versions4---56# Versions78## Create Skill Version910**POST** `/v1/skills/{skill_id}/versions`1112Create Skill Version1314### Path parameters1516- `skill_id: string`1718 Unique identifier for the skill.1920 The format and length of IDs may change over time.2122### Headers2324- `"anthropic-workspace-id": optional string`2526### Body parameters (form-data)2728- `files: array of string`2930 Files to upload for the skill.3132 All files must be in the same top-level directory and must include a SKILL.md file at the root of that directory.3334### Returns3536- `SkillVersion object`3738 - `type: "skill_version"`3940 Object type.4142 For Skill Versions, this is always `"skill_version"`.4344 default: skill_version4546 - `id: string`4748 Unique identifier for this Skill Version. The id addresses the version in49 paths and pins it in references.5051 - `created_at: string`5253 ISO 8601 timestamp of when the skill was created.5455 format: date-time5657 - `description: string`5859 Description of the skill version.6061 This is extracted from the SKILL.md file in the skill upload.6263 - `name: string`6465 The Skill's immutable kebab-case slug, set at creation from the first66 upload's SKILL.md frontmatter `name` (or its enclosing directory). Every67 later upload must resolve to the same value. Also the top-level directory68 of the Skill's mounted files and the base name of a downloaded archive.6970 - `skill_id: string`7172 Unique identifier for the skill.7374 The format and length of IDs may change over time.7576### Example7778```bash79curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions \80 -H 'Content-Type: multipart/form-data' \81 -H 'anthropic-version: 2023-06-01' \82 -H "X-Api-Key: $ANTHROPIC_API_KEY" \83 -F 'files[]=@/path/to/file'84```8586#### Response (200)8788```json89{90 "id": "id",91 "created_at": "2024-10-30T23:58:27.427722Z",92 "description": "description",93 "name": "name",94 "skill_id": "skill_01JAbcdefghijklmnopqrstuvw",95 "type": "skill_version"96}97```9899## List Skill Versions100101**GET** `/v1/skills/{skill_id}/versions`102103List Skill Versions104105### Path parameters106107- `skill_id: string`108109 Unique identifier for the skill.110111 The format and length of IDs may change over time.112113### Query parameters114115- `limit: optional number`116117 Number of results to return per page.118119 Ranges from `1` to `1000`. Defaults to `20`.120121 default: 20, minimum: 1, maximum: 1000122123- `page: optional string`124125 Optionally set to the `next_page` token from the previous response.126127### Headers128129- `"anthropic-workspace-id": optional string`130131### Returns132133- `data: array of SkillVersion`134135 List of skills.136137 - `type: "skill_version"`138139 Object type.140141 For Skill Versions, this is always `"skill_version"`.142143 default: skill_version144145 - `id: string`146147 Unique identifier for this Skill Version. The id addresses the version in148 paths and pins it in references.149150 - `created_at: string`151152 ISO 8601 timestamp of when the skill was created.153154 format: date-time155156 - `description: string`157158 Description of the skill version.159160 This is extracted from the SKILL.md file in the skill upload.161162 - `name: string`163164 The Skill's immutable kebab-case slug, set at creation from the first165 upload's SKILL.md frontmatter `name` (or its enclosing directory). Every166 later upload must resolve to the same value. Also the top-level directory167 of the Skill's mounted files and the base name of a downloaded archive.168169 - `skill_id: string`170171 Unique identifier for the skill.172173 The format and length of IDs may change over time.174175- `next_page: string or null`176177 Token for fetching the next page of results.178179 If `null`, there are no more results available. Pass this value to the `page` parameter in the next request to get the next page.180181### Example182183```bash184curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions \185 -H 'anthropic-version: 2023-06-01' \186 -H "X-Api-Key: $ANTHROPIC_API_KEY"187```188189#### Response (200)190191```json192{193 "data": [194 {195 "id": "id",196 "created_at": "2024-10-30T23:58:27.427722Z",197 "description": "description",198 "name": "name",199 "skill_id": "skill_01JAbcdefghijklmnopqrstuvw",200 "type": "skill_version"201 }202 ],203 "next_page": "next_page"204}205```206207## Get Skill Version208209**GET** `/v1/skills/{skill_id}/versions/{version}`210211Get Skill Version212213### Path parameters214215- `skill_id: string`216217 Unique identifier for the skill.218219 The format and length of IDs may change over time.220221- `version: string`222223 Identifies the skill version: a version ID, or the literal `latest` for the skill's most recent version.224225 Requests carrying the `skills-2025-10-02` beta header address versions by their Unix epoch timestamp instead (e.g., "1759178010641129").226227### Headers228229- `"anthropic-workspace-id": optional string`230231### Returns232233- `SkillVersion object`234235 - `type: "skill_version"`236237 Object type.238239 For Skill Versions, this is always `"skill_version"`.240241 default: skill_version242243 - `id: string`244245 Unique identifier for this Skill Version. The id addresses the version in246 paths and pins it in references.247248 - `created_at: string`249250 ISO 8601 timestamp of when the skill was created.251252 format: date-time253254 - `description: string`255256 Description of the skill version.257258 This is extracted from the SKILL.md file in the skill upload.259260 - `name: string`261262 The Skill's immutable kebab-case slug, set at creation from the first263 upload's SKILL.md frontmatter `name` (or its enclosing directory). Every264 later upload must resolve to the same value. Also the top-level directory265 of the Skill's mounted files and the base name of a downloaded archive.266267 - `skill_id: string`268269 Unique identifier for the skill.270271 The format and length of IDs may change over time.272273### Example274275```bash276curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions/$VERSION \277 -H 'anthropic-version: 2023-06-01' \278 -H "X-Api-Key: $ANTHROPIC_API_KEY"279```280281#### Response (200)282283```json284{285 "id": "id",286 "created_at": "2024-10-30T23:58:27.427722Z",287 "description": "description",288 "name": "name",289 "skill_id": "skill_01JAbcdefghijklmnopqrstuvw",290 "type": "skill_version"291}292```293294## Delete Skill Version295296**DELETE** `/v1/skills/{skill_id}/versions/{version}`297298Delete Skill Version299300### Path parameters301302- `skill_id: string`303304 Unique identifier for the skill.305306 The format and length of IDs may change over time.307308- `version: string`309310 Identifies the skill version by its version ID.311312 Requests carrying the `skills-2025-10-02` beta header address versions by their Unix epoch timestamp instead (e.g., "1759178010641129").313314### Headers315316- `"anthropic-workspace-id": optional string`317318### Returns319320- `DeletedSkillVersion object`321322 - `type: "skill_version_deleted"`323324 Deleted object type.325326 For Skill Versions, this is always `"skill_version_deleted"`.327328 default: skill_version_deleted329330 - `id: string`331332 Unique identifier for this Skill Version. The id addresses the version in333 paths and pins it in references.334335### Example336337```bash338curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions/$VERSION \339 -X DELETE \340 -H 'anthropic-version: 2023-06-01' \341 -H "X-Api-Key: $ANTHROPIC_API_KEY"342```343344#### Response (200)345346```json347{348 "id": "id",349 "type": "skill_version_deleted"350}351```352353## Domain types354355### Deleted Skill Version356357- `DeletedSkillVersion object`358359 - `type: "skill_version_deleted"`360361 Deleted object type.362363 For Skill Versions, this is always `"skill_version_deleted"`.364365 default: skill_version_deleted366367 - `id: string`368369 Unique identifier for this Skill Version. The id addresses the version in370 paths and pins it in references.371372### Skill Version373374- `SkillVersion object`375376 - `type: "skill_version"`377378 Object type.379380 For Skill Versions, this is always `"skill_version"`.381382 default: skill_version383384 - `id: string`385386 Unique identifier for this Skill Version. The id addresses the version in387 paths and pins it in references.388389 - `created_at: string`390391 ISO 8601 timestamp of when the skill was created.392393 format: date-time394395 - `description: string`396397 Description of the skill version.398399 This is extracted from the SKILL.md file in the skill upload.400401 - `name: string`402403 The Skill's immutable kebab-case slug, set at creation from the first404 upload's SKILL.md frontmatter `name` (or its enclosing directory). Every405 later upload must resolve to the same value. Also the top-level directory406 of the Skill's mounted files and the base name of a downloaded archive.407408 - `skill_id: string`409410 Unique identifier for the skill.411412 The format and length of IDs may change over time.413