### Beta Deleted Skill Version ### Beta Skill Version ### Version Create Response ### Version List Response ### Version Retrieve Response ### Version Delete Response
The whole hunk
from line 116, old and new numbered
/
lines
from line 116
116116
117117### Returns
118118
119- `id: string`
119- `BetaSkillVersion object`
120120
121 Unique identifier for the skill version.
121 - `id: string`
122122
123 The format and length of IDs may change over time.
123 Unique identifier for this Skill Version. The id addresses the version in
124 paths and pins it in references.
124125
125- `created_at: string`
126 - `created_at: string`
126127
127 ISO 8601 timestamp of when the skill version was created.
128 ISO 8601 timestamp of when the skill was created.
128129
129- `description: string`
130 format: date-time
130131
131 Description of the skill version.
132 - `description: string`
132133
133 This is extracted from the SKILL.md file in the skill upload.
134 Description of the skill version.
134135
135- `directory: string`
136 This is extracted from the SKILL.md file in the skill upload.
136137
137 Directory name of the skill version.
138 - `name: string`
138139
139 This is the top-level directory name that was extracted from the uploaded files.
140 The Skill's immutable kebab-case slug, set at creation from the first
141 upload's SKILL.md frontmatter `name` (or its enclosing directory). Every
142 later upload must resolve to the same value. Also the top-level directory
143 of the Skill's mounted files and the base name of a downloaded archive.
140144
141- `name: string`
145 - `skill_id: string`
142146
143 Human-readable name of the skill version.
147 Unique identifier for the skill.
144148
145 This is extracted from the SKILL.md file in the skill upload.
149 The format and length of IDs may change over time.
146150
147- `skill_id: string`
151 - `type: "skill_version"`
148152
149 Identifier for the skill that this version belongs to.
153 Object type.
150154
151- `type: string`
155 For Skill Versions, this is always `"skill_version"`.
152156
153 Object type.
157 default: skill_version
154158
155 For Skill Versions, this is always `"skill_version"`.
156
157 default: skill_version
158
159- `version: string`
160
161 Version identifier for the skill.
162
163 Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129").
164
165159### Example
166160
167161```bash
from line 162
168162curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions \
169163 -H 'Content-Type: multipart/form-data' \
170164 -H 'anthropic-version: 2023-06-01' \
171 -H 'anthropic-beta: skills-2025-10-02' \
172165 -H "X-Api-Key: $ANTHROPIC_API_KEY" \
173166 -F files='["Example data"]'
174167```
from line 170
177170
178171```json
179172{
180 "id": "skillver_01JAbcdefghijklmnopqrstuvw",
173 "id": "id",
181174 "created_at": "2024-10-30T23:58:27.427722Z",
182 "description": "A custom skill for doing something useful",
183 "directory": "my-skill",
184 "name": "my-skill",
175 "description": "description",
176 "name": "name",
185177 "skill_id": "skill_01JAbcdefghijklmnopqrstuvw",
186 "type": "type",
187 "version": "1759178010641129"
178 "type": "skill_version"
188179}
189180```
190181
from line 197
206197
207198- `limit: optional number`
208199
209 Number of items to return per page.
200 Number of results to return per page.
210201
211 Defaults to `20`. Ranges from `1` to `1000`.
202 Ranges from `1` to `1000`. Defaults to `20`.
212203
204 default: 20, minimum: 1, maximum: 1000
205
213206- `page: optional string`
214207
215208 Optionally set to the `next_page` token from the previous response.
from line 301
308301
309302### Returns
310303
311- `data: array of object`
304- `data: array of BetaSkillVersion`
312305
313 List of skill versions.
306 List of skills.
314307
315308 - `id: string`
316309
317 Unique identifier for the skill version.
310 Unique identifier for this Skill Version. The id addresses the version in
311 paths and pins it in references.
318312
319 The format and length of IDs may change over time.
320
321313 - `created_at: string`
322314
323 ISO 8601 timestamp of when the skill version was created.
315 ISO 8601 timestamp of when the skill was created.
324316
317 format: date-time
318
325319 - `description: string`
326320
327321 Description of the skill version.
from line 322
328322
329323 This is extracted from the SKILL.md file in the skill upload.
330324
331 - `directory: string`
332
333 Directory name of the skill version.
334
335 This is the top-level directory name that was extracted from the uploaded files.
336
337325 - `name: string`
338326
339 Human-readable name of the skill version.
327 The Skill's immutable kebab-case slug, set at creation from the first
328 upload's SKILL.md frontmatter `name` (or its enclosing directory). Every
329 later upload must resolve to the same value. Also the top-level directory
330 of the Skill's mounted files and the base name of a downloaded archive.
340331
341 This is extracted from the SKILL.md file in the skill upload.
342
343332 - `skill_id: string`
344333
345 Identifier for the skill that this version belongs to.
334 Unique identifier for the skill.
346335
347 - `type: string`
336 The format and length of IDs may change over time.
348337
338 - `type: "skill_version"`
339
349340 Object type.
350341
351342 For Skill Versions, this is always `"skill_version"`.
from line 343
352343
353344 default: skill_version
354345
355 - `version: string`
356
357 Version identifier for the skill.
358
359 Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129").
360
361- `has_more: boolean`
362
363 Indicates if there are more results in the requested page direction.
364
365346- `next_page: string or null`
366347
367 Token to provide in as `page` in the subsequent request to retrieve the next page of data.
348 Token for fetching the next page of results.
368349
350 If `null`, there are no more results available. Pass this value to the `page` parameter in the next request to get the next page.
351
369352### Example
370353
371354```bash
372355curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions \
373356 -H 'anthropic-version: 2023-06-01' \
374 -H 'anthropic-beta: skills-2025-10-02' \
375357 -H "X-Api-Key: $ANTHROPIC_API_KEY"
376358```
377359
from line 363
381363{
382364 "data": [
383365 {
384 "id": "skillver_01JAbcdefghijklmnopqrstuvw",
366 "id": "id",
385367 "created_at": "2024-10-30T23:58:27.427722Z",
386 "description": "A custom skill for doing something useful",
387 "directory": "my-skill",
388 "name": "my-skill",
368 "description": "description",
369 "name": "name",
389370 "skill_id": "skill_01JAbcdefghijklmnopqrstuvw",
390 "type": "type",
391 "version": "1759178010641129"
371 "type": "skill_version"
392372 }
393373 ],
394 "has_more": true,
395 "next_page": "page_MjAyNS0wNS0xNFQwMDowMDowMFo="
374 "next_page": "next_page"
396375}
397376```
398377
from line 391
412391
413392- `version: string`
414393
415 Version identifier for the skill.
394 Identifies the skill version by its version ID.
416395
417 Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129").
396 Requests carrying the `skills-2025-10-02` beta header address versions by their Unix epoch timestamp instead (e.g., "1759178010641129").
418397
419398### Headers
420399
from line 492
513492```bash
514493curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions/$VERSION/content \
515494 -H 'anthropic-version: 2023-06-01' \
516 -H 'anthropic-beta: skills-2025-10-02' \
517495 -H "X-Api-Key: $ANTHROPIC_API_KEY"
518496```
519497
from line 511
533511
534512- `version: string`
535513
536 Version identifier for the skill.
514 Identifies the skill version: a version ID, or the literal `latest` for the skill's most recent version.
537515
538 Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129").
516 Requests carrying the `skills-2025-10-02` beta header address versions by their Unix epoch timestamp instead (e.g., "1759178010641129").
539517
540518### Headers
541519
from line 609
631609
632610### Returns
633611
634- `id: string`
612- `BetaSkillVersion object`
635613
636 Unique identifier for the skill version.
614 - `id: string`
637615
638 The format and length of IDs may change over time.
616 Unique identifier for this Skill Version. The id addresses the version in
617 paths and pins it in references.
639618
640- `created_at: string`
619 - `created_at: string`
641620
642 ISO 8601 timestamp of when the skill version was created.
621 ISO 8601 timestamp of when the skill was created.
643622
644- `description: string`
623 format: date-time
645624
646 Description of the skill version.
625 - `description: string`
647626
648 This is extracted from the SKILL.md file in the skill upload.
627 Description of the skill version.
649628
650- `directory: string`
629 This is extracted from the SKILL.md file in the skill upload.
651630
652 Directory name of the skill version.
631 - `name: string`
653632
654 This is the top-level directory name that was extracted from the uploaded files.
633 The Skill's immutable kebab-case slug, set at creation from the first
634 upload's SKILL.md frontmatter `name` (or its enclosing directory). Every
635 later upload must resolve to the same value. Also the top-level directory
636 of the Skill's mounted files and the base name of a downloaded archive.
655637
656- `name: string`
638 - `skill_id: string`
657639
658 Human-readable name of the skill version.
640 Unique identifier for the skill.
659641
660 This is extracted from the SKILL.md file in the skill upload.
642 The format and length of IDs may change over time.
661643
662- `skill_id: string`
644 - `type: "skill_version"`
663645
664 Identifier for the skill that this version belongs to.
646 Object type.
665647
666- `type: string`
648 For Skill Versions, this is always `"skill_version"`.
667649
668 Object type.
650 default: skill_version
669651
670 For Skill Versions, this is always `"skill_version"`.
671
672 default: skill_version
673
674- `version: string`
675
676 Version identifier for the skill.
677
678 Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129").
679
680652### Example
681653
682654```bash
683655curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions/$VERSION \
684656 -H 'anthropic-version: 2023-06-01' \
685 -H 'anthropic-beta: skills-2025-10-02' \
686657 -H "X-Api-Key: $ANTHROPIC_API_KEY"
687658```
688659
from line 661
690661
691662```json
692663{
693 "id": "skillver_01JAbcdefghijklmnopqrstuvw",
664 "id": "id",
694665 "created_at": "2024-10-30T23:58:27.427722Z",
695 "description": "A custom skill for doing something useful",
696 "directory": "my-skill",
697 "name": "my-skill",
666 "description": "description",
667 "name": "name",
698668 "skill_id": "skill_01JAbcdefghijklmnopqrstuvw",
699 "type": "type",
700 "version": "1759178010641129"
669 "type": "skill_version"
701670}
702671```
703672
from line 686
717686
718687- `version: string`
719688
720 Version identifier for the skill.
689 Identifies the skill version by its version ID.
721690
722 Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129").
691 Requests carrying the `skills-2025-10-02` beta header address versions by their Unix epoch timestamp instead (e.g., "1759178010641129").
723692
724693### Headers
725694
from line 784
815784
816785### Returns
817786
818- `id: string`
787- `BetaDeletedSkillVersion object`
819788
820 Version identifier for the skill.
789 - `id: string`
821790
822 Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129").
791 Unique identifier for this Skill Version. The id addresses the version in
792 paths and pins it in references.
823793
824- `type: string`
794 - `type: "skill_version_deleted"`
825795
826 Deleted object type.
796 Deleted object type.
827797
828 For Skill Versions, this is always `"skill_version_deleted"`.
798 For Skill Versions, this is always `"skill_version_deleted"`.
829799
830 default: skill_version_deleted
800 default: skill_version_deleted
831801
832802### Example
833803
from line 805
835805curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions/$VERSION \
836806 -X DELETE \
837807 -H 'anthropic-version: 2023-06-01' \
838 -H 'anthropic-beta: skills-2025-10-02' \
839808 -H "X-Api-Key: $ANTHROPIC_API_KEY"
840809```
841810
from line 812
843812
844813```json
845814{
846 "id": "1759178010641129",
847 "type": "type"
815 "id": "id",
816 "type": "skill_version_deleted"
848817}
849818```
850819
851820## Domain types
852821
853### Version Create Response
822### Beta Deleted Skill Version
854823
855- `VersionCreateResponse object`
824- `BetaDeletedSkillVersion object`
856825
857826 - `id: string`
858827
859 Unique identifier for the skill version.
828 Unique identifier for this Skill Version. The id addresses the version in
829 paths and pins it in references.
860830
861 The format and length of IDs may change over time.
831 - `type: "skill_version_deleted"`
862832
863 - `created_at: string`
833 Deleted object type.
864834
865 ISO 8601 timestamp of when the skill version was created.
835 For Skill Versions, this is always `"skill_version_deleted"`.
866836
867 - `description: string`
837 default: skill_version_deleted
868838
869 Description of the skill version.
839### Beta Skill Version
870840
871 This is extracted from the SKILL.md file in the skill upload.
841- `BetaSkillVersion object`
872842
873 - `directory: string`
874
875 Directory name of the skill version.
876
877 This is the top-level directory name that was extracted from the uploaded files.
878
879 - `name: string`
880
881 Human-readable name of the skill version.
882
883 This is extracted from the SKILL.md file in the skill upload.
884
885 - `skill_id: string`
886
887 Identifier for the skill that this version belongs to.
888
889 - `type: string`
890
891 Object type.
892
893 For Skill Versions, this is always `"skill_version"`.
894
895 default: skill_version
896
897 - `version: string`
898
899 Version identifier for the skill.
900
901 Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129").
902
903### Version List Response
904
905- `VersionListResponse object`
906
907843 - `id: string`
908844
909 Unique identifier for the skill version.
845 Unique identifier for this Skill Version. The id addresses the version in
846 paths and pins it in references.
910847
911 The format and length of IDs may change over time.
912
913848 - `created_at: string`
914849
915 ISO 8601 timestamp of when the skill version was created.
850 ISO 8601 timestamp of when the skill was created.
916851
852 format: date-time
853
917854 - `description: string`
918855
919856 Description of the skill version.
from line 857
920857
921858 This is extracted from the SKILL.md file in the skill upload.
922859
923 - `directory: string`
924
925 Directory name of the skill version.
926
927 This is the top-level directory name that was extracted from the uploaded files.
928
929860 - `name: string`
930861
931 Human-readable name of the skill version.
862 The Skill's immutable kebab-case slug, set at creation from the first
863 upload's SKILL.md frontmatter `name` (or its enclosing directory). Every
864 later upload must resolve to the same value. Also the top-level directory
865 of the Skill's mounted files and the base name of a downloaded archive.
932866
933 This is extracted from the SKILL.md file in the skill upload.
934
935867 - `skill_id: string`
936868
937 Identifier for the skill that this version belongs to.
869 Unique identifier for the skill.
938870
939 - `type: string`
940
941 Object type.
942
943 For Skill Versions, this is always `"skill_version"`.
944
945 default: skill_version
946
947 - `version: string`
948
949 Version identifier for the skill.
950
951 Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129").
952
953### Version Retrieve Response
954
955- `VersionRetrieveResponse object`
956
957 - `id: string`
958
959 Unique identifier for the skill version.
960
961871 The format and length of IDs may change over time.
962872
963 - `created_at: string`
873 - `type: "skill_version"`
964874
965 ISO 8601 timestamp of when the skill version was created.
966
967 - `description: string`
968
969 Description of the skill version.
970
971 This is extracted from the SKILL.md file in the skill upload.
972
973 - `directory: string`
974
975 Directory name of the skill version.
976
977 This is the top-level directory name that was extracted from the uploaded files.
978
979 - `name: string`
980
981 Human-readable name of the skill version.
982
983 This is extracted from the SKILL.md file in the skill upload.
984
985 - `skill_id: string`
986
987 Identifier for the skill that this version belongs to.
988
989 - `type: string`
990
991875 Object type.
992876
993877 For Skill Versions, this is always `"skill_version"`.
994878
995879 default: skill_version
996
997 - `version: string`
998
999 Version identifier for the skill.
1000
1001 Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129").
1002
1003### Version Delete Response
1004
1005- `VersionDeleteResponse object`
1006
1007 - `id: string`
1008
1009 Version identifier for the skill.
1010
1011 Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129").
1012
1013 - `type: string`
1014
1015 Deleted object type.
1016
1017 For Skill Versions, this is always `"skill_version_deleted"`.
1018
1019 default: skill_version_deleted
1020880