Versions changedapi/skills/versions
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.
Recorded here
Lines+47added
Lines−34removed
From line
1
where the diff opens
First seen
20 Aug 2026
this site's first read of the page
Recorded edits8to this page, all time
### 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
The whole hunk
from line 1, old and new numbered
/
from line 1
1---
2title: Versions
3url: https://platform.claude.com/docs/en/api/skills/versions
4---
5
61# Versions
72
83## Create Skill Version
94
10**post** `/v1/skills/{skill_id}/versions`
5**POST** `/v1/skills/{skill_id}/versions`
116
127Create Skill Version
138
14### Path Parameters
9### Path parameters
1510
1611- `skill_id: string`
1712
from line 14
1914
2015 The format and length of IDs may change over time.
2116
17### Body parameters (form-data)
18
19- `files: array of string`
20
21 Files to upload for the skill.
22
23 All files must be in the same top-level directory and must include a SKILL.md file at the root of that directory.
24
2225### Returns
2326
24- `SkillVersion object { id, created_at, description, 3 more }`
27- `SkillVersion object`
2528
2629 - `id: string`
2730
from line 35
3235
3336 ISO 8601 timestamp of when the skill was created.
3437
38 format: date-time
39
3540 - `description: string`
3641
3742 Description of the skill version.
from line 62
5762
5863 For Skill Versions, this is always `"skill_version"`.
5964
60 - `"skill_version"`
65 default: skill_version
6166
6267### Example
6368
64```http
69```bash
6570curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions \
6671 -H 'Content-Type: multipart/form-data' \
6772 -H 'anthropic-version: 2023-06-01' \
from line 74
6974 -F files='["Example data"]'
7075```
7176
72#### Response
77#### Response (200)
7378
7479```json
7580{
from line 89
8489
8590## List Skill Versions
8691
87**get** `/v1/skills/{skill_id}/versions`
92**GET** `/v1/skills/{skill_id}/versions`
8893
8994List Skill Versions
9095
91### Path Parameters
96### Path parameters
9297
9398- `skill_id: string`
9499
from line 101
96101
97102 The format and length of IDs may change over time.
98103
99### Query Parameters
104### Query parameters
100105
101106- `limit: optional number`
102107
from line 109
104109
105110 Ranges from `1` to `1000`. Defaults to `20`.
106111
112 default: 20, minimum: 1, maximum: 1000
113
107114- `page: optional string`
108115
109116 Optionally set to the `next_page` token from the previous response.
from line 130
123130
124131 ISO 8601 timestamp of when the skill was created.
125132
133 format: date-time
134
126135 - `description: string`
127136
128137 Description of the skill version.
from line 157
148157
149158 For Skill Versions, this is always `"skill_version"`.
150159
151 - `"skill_version"`
160 default: skill_version
152161
153162- `next_page: string or null`
154163
from line 167
158167
159168### Example
160169
161```http
170```bash
162171curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions \
163172 -H 'anthropic-version: 2023-06-01' \
164173 -H "X-Api-Key: $ANTHROPIC_API_KEY"
165174```
166175
167#### Response
176#### Response (200)
168177
169178```json
170179{
from line 193
184193
185194## Get Skill Version
186195
187**get** `/v1/skills/{skill_id}/versions/{version}`
196**GET** `/v1/skills/{skill_id}/versions/{version}`
188197
189198Get Skill Version
190199
191### Path Parameters
200### Path parameters
192201
193202- `skill_id: string`
194203
from line 213
204213
205214### Returns
206215
207- `SkillVersion object { id, created_at, description, 3 more }`
216- `SkillVersion object`
208217
209218 - `id: string`
210219
from line 224
215224
216225 ISO 8601 timestamp of when the skill was created.
217226
227 format: date-time
228
218229 - `description: string`
219230
220231 Description of the skill version.
from line 251
240251
241252 For Skill Versions, this is always `"skill_version"`.
242253
243 - `"skill_version"`
254 default: skill_version
244255
245256### Example
246257
247```http
258```bash
248259curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions/$VERSION \
249260 -H 'anthropic-version: 2023-06-01' \
250261 -H "X-Api-Key: $ANTHROPIC_API_KEY"
251262```
252263
253#### Response
264#### Response (200)
254265
255266```json
256267{
from line 276
265276
266277## Delete Skill Version
267278
268**delete** `/v1/skills/{skill_id}/versions/{version}`
279**DELETE** `/v1/skills/{skill_id}/versions/{version}`
269280
270281Delete Skill Version
271282
272### Path Parameters
283### Path parameters
273284
274285- `skill_id: string`
275286
from line 296
285296
286297### Returns
287298
288- `DeletedSkillVersion object { id, type }`
299- `DeletedSkillVersion object`
289300
290301 - `id: string`
291302
from line 309
298309
299310 For Skill Versions, this is always `"skill_version_deleted"`.
300311
301 - `"skill_version_deleted"`
312 default: skill_version_deleted
302313
303314### Example
304315
305```http
316```bash
306317curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions/$VERSION \
307318 -X DELETE \
308319 -H 'anthropic-version: 2023-06-01' \
from line 320
309320 -H "X-Api-Key: $ANTHROPIC_API_KEY"
310321```
311322
312#### Response
323#### Response (200)
313324
314325```json
315326{
from line 329
318329}
319330```
320331
321## Domain Types
332## Domain types
322333
323334### Deleted Skill Version
324335
325- `DeletedSkillVersion object { id, type }`
336- `DeletedSkillVersion object`
326337
327338 - `id: string`
328339
from line 346
335346
336347 For Skill Versions, this is always `"skill_version_deleted"`.
337348
338 - `"skill_version_deleted"`
349 default: skill_version_deleted
339350
340351### Skill Version
341352
342- `SkillVersion object { id, created_at, description, 3 more }`
353- `SkillVersion object`
343354
344355 - `id: string`
345356
from line 361
350361
351362 ISO 8601 timestamp of when the skill was created.
352363
364 format: date-time
365
353366 - `description: string`
354367
355368 Description of the skill version.
from line 388
375388
376389 For Skill Versions, this is always `"skill_version"`.
377390
378 - `"skill_version"`
391 default: skill_version
379392
No line in this hunk matches that.