One change

Versions

api/skills/versions

25 Aug 2026 03:37 UTC first seen 20 Aug 2026 The page's own history The capture it came from

Nearest release: v2.1.245, published an hour after this site recorded the change. Shown because the two are within 24 hours of each other. Nothing here says the release caused the edit.

api/skills/versions Changed · +47 / -34 lines

### Path parameters ### Body parameters (form-data) #### Response (200) ### Path parameters ### Query parameters #### Response (200) ### Path parameters #### Response (200) ### Path parameters #### Response (200) ## Domain types ### Path Parameters #### Response ### Path Parameters ### Query Parameters #### Response ### Path Parameters #### Response ### Path Parameters #### Response ## Domain Types

from line 1

----
-title: Versions
-url: https://platform.claude.com/docs/en/api/skills/versions
----
-
 # Versions
 
 ## Create Skill Version
 
-**post** `/v1/skills/{skill_id}/versions`
+**POST** `/v1/skills/{skill_id}/versions`
 
 Create Skill Version
 
-### Path Parameters
+### Path parameters
 
 - `skill_id: string`

from line 14

 
   The format and length of IDs may change over time.
 
+### Body parameters (form-data)
+
+- `files: array of string`
+
+  Files to upload for the skill.
+
+  All files must be in the same top-level directory and must include a SKILL.md file at the root of that directory.
+
 ### Returns
 
-- `SkillVersion object { id, created_at, description, 3 more }`
+- `SkillVersion object`
 
   - `id: string`

from line 35

 
     ISO 8601 timestamp of when the skill was created.
 
+    format: date-time
+
   - `description: string`
 
     Description of the skill version.

from line 62

 
     For Skill Versions, this is always `"skill_version"`.
 
-    - `"skill_version"`
+    default: skill_version
 
 ### Example
 
-```http
+```bash
 curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions \
     -H 'Content-Type: multipart/form-data' \
     -H 'anthropic-version: 2023-06-01' \

from line 74

     -F files='["Example data"]'
 ```
 
-#### Response
+#### Response (200)
 
 ```json
 {

from line 89

 
 ## List Skill Versions
 
-**get** `/v1/skills/{skill_id}/versions`
+**GET** `/v1/skills/{skill_id}/versions`
 
 List Skill Versions
 
-### Path Parameters
+### Path parameters
 
 - `skill_id: string`

from line 101

 
   The format and length of IDs may change over time.
 
-### Query Parameters
+### Query parameters
 
 - `limit: optional number`

from line 109

 
   Ranges from `1` to `1000`. Defaults to `20`.
 
+  default: 20, minimum: 1, maximum: 1000
+
 - `page: optional string`
 
   Optionally set to the `next_page` token from the previous response.

from line 130

 
     ISO 8601 timestamp of when the skill was created.
 
+    format: date-time
+
   - `description: string`
 
     Description of the skill version.

from line 157

 
     For Skill Versions, this is always `"skill_version"`.
 
-    - `"skill_version"`
+    default: skill_version
 
 - `next_page: string or null`

from line 167

 
 ### Example
 
-```http
+```bash
 curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions \
     -H 'anthropic-version: 2023-06-01' \
     -H "X-Api-Key: $ANTHROPIC_API_KEY"
 ```
 
-#### Response
+#### Response (200)
 
 ```json
 {

from line 193

 
 ## Get Skill Version
 
-**get** `/v1/skills/{skill_id}/versions/{version}`
+**GET** `/v1/skills/{skill_id}/versions/{version}`
 
 Get Skill Version
 
-### Path Parameters
+### Path parameters
 
 - `skill_id: string`

from line 213

 
 ### Returns
 
-- `SkillVersion object { id, created_at, description, 3 more }`
+- `SkillVersion object`
 
   - `id: string`

from line 224

 
     ISO 8601 timestamp of when the skill was created.
 
+    format: date-time
+
   - `description: string`
 
     Description of the skill version.

from line 251

 
     For Skill Versions, this is always `"skill_version"`.
 
-    - `"skill_version"`
+    default: skill_version
 
 ### Example
 
-```http
+```bash
 curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions/$VERSION \
     -H 'anthropic-version: 2023-06-01' \
     -H "X-Api-Key: $ANTHROPIC_API_KEY"
 ```
 
-#### Response
+#### Response (200)
 
 ```json
 {

from line 276

 
 ## Delete Skill Version
 
-**delete** `/v1/skills/{skill_id}/versions/{version}`
+**DELETE** `/v1/skills/{skill_id}/versions/{version}`
 
 Delete Skill Version
 
-### Path Parameters
+### Path parameters
 
 - `skill_id: string`

from line 296

 
 ### Returns
 
-- `DeletedSkillVersion object { id, type }`
+- `DeletedSkillVersion object`
 
   - `id: string`

from line 309

 
     For Skill Versions, this is always `"skill_version_deleted"`.
 
-    - `"skill_version_deleted"`
+    default: skill_version_deleted
 
 ### Example
 
-```http
+```bash
 curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions/$VERSION \
     -X DELETE \
     -H 'anthropic-version: 2023-06-01' \

from line 320

     -H "X-Api-Key: $ANTHROPIC_API_KEY"
 ```
 
-#### Response
+#### Response (200)
 
 ```json
 {

from line 329

 }
 ```
 
-## Domain Types
+## Domain types
 
 ### Deleted Skill Version
 
-- `DeletedSkillVersion object { id, type }`
+- `DeletedSkillVersion object`
 
   - `id: string`

from line 346

 
     For Skill Versions, this is always `"skill_version_deleted"`.
 
-    - `"skill_version_deleted"`
+    default: skill_version_deleted
 
 ### Skill Version
 
-- `SkillVersion object { id, created_at, description, 3 more }`
+- `SkillVersion object`
 
   - `id: string`

from line 361

 
     ISO 8601 timestamp of when the skill was created.
 
+    format: date-time
+
   - `description: string`
 
     Description of the skill version.

from line 388

 
     For Skill Versions, this is always `"skill_version"`.
 
-    - `"skill_version"`
+    default: skill_version