Versions changedapi/beta/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+55added
Lines−36removed
From line
1
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits19to this page, all time
### Path parameters ### Headers ### Body parameters (form-data) #### Response (200) ### Path parameters ### Query parameters ### Headers #### Response (200) ### Path parameters ### Headers ### Path parameters ### Headers #### Response (200) ### Path parameters ### Headers #### Response (200) ## Domain types ### Path Parameters ### Header Parameters #### Response ### Path Parameters ### Query Parameters ### Header Parameters #### Response ### Path Parameters ### Header Parameters ### Path Parameters ### Header Parameters #### Response ### Path Parameters ### Header 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/beta/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
22### Header Parameters
17### Headers
2318
2419- `"anthropic-beta": optional array of AnthropicBeta`
2520
from line 92
9792
9893 - `"mid-conversation-tool-changes-2026-07-01"`
9994
95### Body parameters (form-data)
96
97- `files: array of string`
98
99 Files to upload for the skill.
100
101 All files must be in the same top-level directory and must include a SKILL.md file at the root of that directory.
102
100103### Returns
101104
102105- `id: string`
from line 140
137140
138141 For Skill Versions, this is always `"skill_version"`.
139142
143 default: skill_version
144
140145- `version: string`
141146
142147 Version identifier for the skill.
from line 150
145150
146151### Example
147152
148```http
153```bash
149154curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions \
150155 -H 'Content-Type: multipart/form-data' \
151156 -H 'anthropic-version: 2023-06-01' \
from line 159
154159 -F files='["Example data"]'
155160```
156161
157#### Response
162#### Response (200)
158163
159164```json
160165{
from line 176
171176
172177## List Skill Versions
173178
174**get** `/v1/skills/{skill_id}/versions`
179**GET** `/v1/skills/{skill_id}/versions`
175180
176181List Skill Versions
177182
178### Path Parameters
183### Path parameters
179184
180185- `skill_id: string`
181186
from line 188
183188
184189 The format and length of IDs may change over time.
185190
186### Query Parameters
191### Query parameters
187192
188193- `limit: optional number`
189194
from line 200
195200
196201 Optionally set to the `next_page` token from the previous response.
197202
198### Header Parameters
203### Headers
199204
200205- `"anthropic-beta": optional array of AnthropicBeta`
201206
from line 280
275280
276281### Returns
277282
278- `data: array of object { id, created_at, description, 5 more }`
283- `data: array of object`
279284
280285 List of skill versions.
281286
from line 322
317322
318323 For Skill Versions, this is always `"skill_version"`.
319324
325 default: skill_version
326
320327 - `version: string`
321328
322329 Version identifier for the skill.
from line 340
333340
334341### Example
335342
336```http
343```bash
337344curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions \
338345 -H 'anthropic-version: 2023-06-01' \
339346 -H 'anthropic-beta: skills-2025-10-02' \
from line 347
340347 -H "X-Api-Key: $ANTHROPIC_API_KEY"
341348```
342349
343#### Response
350#### Response (200)
344351
345352```json
346353{
from line 370
363370
364371## Download Skill Version Content
365372
366**get** `/v1/skills/{skill_id}/versions/{version}/content`
373**GET** `/v1/skills/{skill_id}/versions/{version}/content`
367374
368375Download a skill version's content as a zip archive.
369376
370### Path Parameters
377### Path parameters
371378
372379- `skill_id: string`
373380
from line 388
381388
382389 Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129").
383390
384### Header Parameters
391### Headers
385392
386393- `"anthropic-beta": optional array of AnthropicBeta`
387394
from line 468
461468
462469### Example
463470
464```http
471```bash
465472curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions/$VERSION/content \
466473 -H 'anthropic-version: 2023-06-01' \
467474 -H 'anthropic-beta: skills-2025-10-02' \
from line 477
470477
471478## Get Skill Version
472479
473**get** `/v1/skills/{skill_id}/versions/{version}`
480**GET** `/v1/skills/{skill_id}/versions/{version}`
474481
475482Get Skill Version
476483
477### Path Parameters
484### Path parameters
478485
479486- `skill_id: string`
480487
from line 495
488495
489496 Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129").
490497
491### Header Parameters
498### Headers
492499
493500- `"anthropic-beta": optional array of AnthropicBeta`
494501
from line 613
606613
607614 For Skill Versions, this is always `"skill_version"`.
608615
616 default: skill_version
617
609618- `version: string`
610619
611620 Version identifier for the skill.
from line 623
614623
615624### Example
616625
617```http
626```bash
618627curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions/$VERSION \
619628 -H 'anthropic-version: 2023-06-01' \
620629 -H 'anthropic-beta: skills-2025-10-02' \
from line 630
621630 -H "X-Api-Key: $ANTHROPIC_API_KEY"
622631```
623632
624#### Response
633#### Response (200)
625634
626635```json
627636{
from line 647
638647
639648## Delete Skill Version
640649
641**delete** `/v1/skills/{skill_id}/versions/{version}`
650**DELETE** `/v1/skills/{skill_id}/versions/{version}`
642651
643652Delete Skill Version
644653
645### Path Parameters
654### Path parameters
646655
647656- `skill_id: string`
648657
from line 665
656665
657666 Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129").
658667
659### Header Parameters
668### Headers
660669
661670- `"anthropic-beta": optional array of AnthropicBeta`
662671
from line 757
748757
749758 For Skill Versions, this is always `"skill_version_deleted"`.
750759
760 default: skill_version_deleted
761
751762### Example
752763
753```http
764```bash
754765curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions/$VERSION \
755766 -X DELETE \
756767 -H 'anthropic-version: 2023-06-01' \
from line 769
758769 -H "X-Api-Key: $ANTHROPIC_API_KEY"
759770```
760771
761#### Response
772#### Response (200)
762773
763774```json
764775{
from line 778
767778}
768779```
769780
770## Domain Types
781## Domain types
771782
772783### Version Create Response
773784
774- `VersionCreateResponse object { id, created_at, description, 5 more }`
785- `VersionCreateResponse object`
775786
776787 - `id: string`
777788
from line 822
811822
812823 For Skill Versions, this is always `"skill_version"`.
813824
825 default: skill_version
826
814827 - `version: string`
815828
816829 Version identifier for the skill.
from line 832
819832
820833### Version List Response
821834
822- `VersionListResponse object { id, created_at, description, 5 more }`
835- `VersionListResponse object`
823836
824837 - `id: string`
825838
from line 872
859872
860873 For Skill Versions, this is always `"skill_version"`.
861874
875 default: skill_version
876
862877 - `version: string`
863878
864879 Version identifier for the skill.
from line 882
867882
868883### Version Retrieve Response
869884
870- `VersionRetrieveResponse object { id, created_at, description, 5 more }`
885- `VersionRetrieveResponse object`
871886
872887 - `id: string`
873888
from line 922
907922
908923 For Skill Versions, this is always `"skill_version"`.
909924
925 default: skill_version
926
910927 - `version: string`
911928
912929 Version identifier for the skill.
from line 932
915932
916933### Version Delete Response
917934
918- `VersionDeleteResponse object { id, type }`
935- `VersionDeleteResponse object`
919936
920937 - `id: string`
921938
from line 945
928945 Deleted object type.
929946
930947 For Skill Versions, this is always `"skill_version_deleted"`.
948
949 default: skill_version_deleted
931950
No line in this hunk matches that.