### Beta Deleted Skill ### Beta Skill ### Beta Skill Source ### Skill Create Response ### Skill List Response ### Skill Retrieve Response ### Skill Delete Response
The whole hunk
from line 106, old and new numbered
/
lines
The two sides of this change are more than 400 edits apart, too far apart to line up, so this is the differ's own diff of it and the words inside a line are not marked.
from line 106
106106
107107 All files must be in the same top-level directory and must include a SKILL.md file at the root of that directory.
108108
109- `display_title: optional string or null`
110
111 Display title for the skill.
112
113 This is a human-readable label that is not included in the prompt sent to the model.
109- `display_name: optional string or null`
110
111 Human-readable, single-line label for the Skill. Maximum 255 characters.
112 Always set: derived from the SKILL.md frontmatter `name` when omitted at
113 creation. Not unique.
114114
115115### Returns
116116
117- `id: string`
118
119 Unique identifier for the skill.
120
121 The format and length of IDs may change over time.
122
123- `created_at: string`
124
125 ISO 8601 timestamp of when the skill was created.
126
127- `display_title: string or null`
128
129 Display title for the skill.
130
131 This is a human-readable label that is not included in the prompt sent to the model.
132
133- `latest_version: string or null`
134
135 The latest version identifier for the skill.
136
137 This represents the most recent version of the skill that has been created.
138
139- `source: string`
140
141 Source of the skill.
142
143 This may be one of the following values:
144
145 * `"custom"`: the skill was created by a user
146 * `"anthropic"`: the skill was created by Anthropic
147
148- `type: string`
149
150 Object type.
151
152 For Skills, this is always `"skill"`.
153
154 default: skill
155
156- `updated_at: string`
157
158 ISO 8601 timestamp of when the skill was last updated.
117- `BetaSkill object`
118
119 - `id: string`
120
121 Unique identifier for the skill.
122
123 The format and length of IDs may change over time.
124
125 - `created_at: string`
126
127 ISO 8601 timestamp of when the skill was created.
128
129 format: date-time
130
131 - `display_name: string`
132
133 Human-readable, single-line label for the Skill. Maximum 255 characters.
134 Always set: derived from the SKILL.md frontmatter `name` when omitted at
135 creation. Not unique.
136
137 - `latest_version_id: string`
138
139 ID of the newest Skill Version — what `latest` references resolve to. Always set: a Skill holds at least one version.
140
141 - `source: BetaSkillSource`
142
143 Where the Skill comes from.
144
145 Possible values:
146
147 * `"custom"`: authored by the platform user; private to their workspace
148 * `"anthropic"`: published by Anthropic; shared and read-only
149 * `"anthropic_example"`: Anthropic-published sample Skill
150 * `"plugin"`: resolved from an installed plugin
151
152 - `type: "custom" or "anthropic" or "anthropic_example" or "plugin"`
153
154 Where the Skill comes from.
155
156 Possible values:
157
158 * `"custom"`: authored by the platform user; private to their workspace
159 * `"anthropic"`: published by Anthropic; shared and read-only
160 * `"anthropic_example"`: Anthropic-published sample Skill
161 * `"plugin"`: resolved from an installed plugin
162
163 - `"custom"`
164
165 - `"anthropic"`
166
167 - `"anthropic_example"`
168
169 - `"plugin"`
170
171 - `type: "skill"`
172
173 Object type.
174
175 For Skills, this is always `"skill"`.
176
177 default: skill
178
179 - `updated_at: string`
180
181 ISO 8601 timestamp of when the skill was last updated.
182
183 format: date-time
159184
160185### Example
161186
from line 188
163188curl https://api.anthropic.com/v1/skills \
164189 -H 'Content-Type: multipart/form-data' \
165190 -H 'anthropic-version: 2023-06-01' \
166 -H 'anthropic-beta: skills-2025-10-02' \
167191 -H "X-Api-Key: $ANTHROPIC_API_KEY" \
168192 -F files='["Example data"]'
169193```
from line 198
174198{
175199 "id": "skill_01JAbcdefghijklmnopqrstuvw",
176200 "created_at": "2024-10-30T23:58:27.427722Z",
177 "display_title": "My Custom Skill",
178 "latest_version": "1759178010641129",
179 "source": "custom",
180 "type": "type",
201 "display_name": "display_name",
202 "latest_version_id": "latest_version_id",
203 "source": {
204 "type": "custom"
205 },
206 "type": "skill",
181207 "updated_at": "2024-10-30T23:58:27.427722Z"
182208}
183209```
from line 220
194220
195221 Number of results to return per page.
196222
197 Maximum value is 100. Defaults to 20.
198
199 default: 20
223 Ranges from `1` to `1000`. Defaults to `20`.
224
225 default: 20, minimum: 1, maximum: 1000
200226
201227- `page: optional string`
202228
from line 333
307333
308334### Returns
309335
310- `data: array of object`
336- `data: array of BetaSkill`
311337
312338 List of skills.
313339
from line 347
321347
322348 ISO 8601 timestamp of when the skill was created.
323349
324 - `display_title: string or null`
325
326 Display title for the skill.
327
328 This is a human-readable label that is not included in the prompt sent to the model.
329
330 - `latest_version: string or null`
331
332 The latest version identifier for the skill.
333
334 This represents the most recent version of the skill that has been created.
335
336 - `source: string`
337
338 Source of the skill.
339
340 This may be one of the following values:
341
342 * `"custom"`: the skill was created by a user
343 * `"anthropic"`: the skill was created by Anthropic
344
345 - `type: string`
350 format: date-time
351
352 - `display_name: string`
353
354 Human-readable, single-line label for the Skill. Maximum 255 characters.
355 Always set: derived from the SKILL.md frontmatter `name` when omitted at
356 creation. Not unique.
357
358 - `latest_version_id: string`
359
360 ID of the newest Skill Version — what `latest` references resolve to. Always set: a Skill holds at least one version.
361
362 - `source: BetaSkillSource`
363
364 Where the Skill comes from.
365
366 Possible values:
367
368 * `"custom"`: authored by the platform user; private to their workspace
369 * `"anthropic"`: published by Anthropic; shared and read-only
370 * `"anthropic_example"`: Anthropic-published sample Skill
371 * `"plugin"`: resolved from an installed plugin
372
373 - `type: "custom" or "anthropic" or "anthropic_example" or "plugin"`
374
375 Where the Skill comes from.
376
377 Possible values:
378
379 * `"custom"`: authored by the platform user; private to their workspace
380 * `"anthropic"`: published by Anthropic; shared and read-only
381 * `"anthropic_example"`: Anthropic-published sample Skill
382 * `"plugin"`: resolved from an installed plugin
383
384 - `"custom"`
385
386 - `"anthropic"`
387
388 - `"anthropic_example"`
389
390 - `"plugin"`
391
392 - `type: "skill"`
346393
347394 Object type.
348395
from line 401
354401
355402 ISO 8601 timestamp of when the skill was last updated.
356403
357- `has_more: boolean`
358
359 Whether there are more results available.
360
361 If `true`, there are additional results that can be fetched using the `next_page` token.
404 format: date-time
362405
363406- `next_page: string or null`
364407
from line 414
371414```bash
372415curl https://api.anthropic.com/v1/skills \
373416 -H 'anthropic-version: 2023-06-01' \
374 -H 'anthropic-beta: skills-2025-10-02' \
375417 -H "X-Api-Key: $ANTHROPIC_API_KEY"
376418```
377419
from line 425
383425 {
384426 "id": "skill_01JAbcdefghijklmnopqrstuvw",
385427 "created_at": "2024-10-30T23:58:27.427722Z",
386 "display_title": "My Custom Skill",
387 "latest_version": "1759178010641129",
388 "source": "custom",
389 "type": "type",
428 "display_name": "display_name",
429 "latest_version_id": "latest_version_id",
430 "source": {
431 "type": "custom"
432 },
433 "type": "skill",
390434 "updated_at": "2024-10-30T23:58:27.427722Z"
391435 }
392436 ],
393 "has_more": true,
394 "next_page": "page_MjAyNS0wNS0xNFQwMDowMDowMFo="
437 "next_page": "next_page"
395438}
396439```
397440
from line 546
503546
504547### Returns
505548
506- `id: string`
507
508 Unique identifier for the skill.
509
510 The format and length of IDs may change over time.
511
512- `created_at: string`
513
514 ISO 8601 timestamp of when the skill was created.
515
516- `display_title: string or null`
517
518 Display title for the skill.
519
520 This is a human-readable label that is not included in the prompt sent to the model.
521
522- `latest_version: string or null`
523
524 The latest version identifier for the skill.
525
526 This represents the most recent version of the skill that has been created.
527
528- `source: string`
529
530 Source of the skill.
531
532 This may be one of the following values:
533
534 * `"custom"`: the skill was created by a user
535 * `"anthropic"`: the skill was created by Anthropic
536
537- `type: string`
538
539 Object type.
540
541 For Skills, this is always `"skill"`.
542
543 default: skill
544
545- `updated_at: string`
546
547 ISO 8601 timestamp of when the skill was last updated.
549- `BetaSkill object`
550
551 - `id: string`
552
553 Unique identifier for the skill.
554
555 The format and length of IDs may change over time.
556
557 - `created_at: string`
558
559 ISO 8601 timestamp of when the skill was created.
560
561 format: date-time
562
563 - `display_name: string`
564
565 Human-readable, single-line label for the Skill. Maximum 255 characters.
566 Always set: derived from the SKILL.md frontmatter `name` when omitted at
567 creation. Not unique.
568
569 - `latest_version_id: string`
570
571 ID of the newest Skill Version — what `latest` references resolve to. Always set: a Skill holds at least one version.
572
573 - `source: BetaSkillSource`
574
575 Where the Skill comes from.
576
577 Possible values:
578
579 * `"custom"`: authored by the platform user; private to their workspace
580 * `"anthropic"`: published by Anthropic; shared and read-only
581 * `"anthropic_example"`: Anthropic-published sample Skill
582 * `"plugin"`: resolved from an installed plugin
583
584 - `type: "custom" or "anthropic" or "anthropic_example" or "plugin"`
585
586 Where the Skill comes from.
587
588 Possible values:
589
590 * `"custom"`: authored by the platform user; private to their workspace
591 * `"anthropic"`: published by Anthropic; shared and read-only
592 * `"anthropic_example"`: Anthropic-published sample Skill
593 * `"plugin"`: resolved from an installed plugin
594
595 - `"custom"`
596
597 - `"anthropic"`
598
599 - `"anthropic_example"`
600
601 - `"plugin"`
602
603 - `type: "skill"`
604
605 Object type.
606
607 For Skills, this is always `"skill"`.
608
609 default: skill
610
611 - `updated_at: string`
612
613 ISO 8601 timestamp of when the skill was last updated.
614
615 format: date-time
548616
549617### Example
550618
551619```bash
552620curl https://api.anthropic.com/v1/skills/$SKILL_ID \
553621 -H 'anthropic-version: 2023-06-01' \
554 -H 'anthropic-beta: skills-2025-10-02' \
555622 -H "X-Api-Key: $ANTHROPIC_API_KEY"
556623```
557624
from line 628
561628{
562629 "id": "skill_01JAbcdefghijklmnopqrstuvw",
563630 "created_at": "2024-10-30T23:58:27.427722Z",
564 "display_title": "My Custom Skill",
565 "latest_version": "1759178010641129",
566 "source": "custom",
567 "type": "type",
631 "display_name": "display_name",
632 "latest_version_id": "latest_version_id",
633 "source": {
634 "type": "custom"
635 },
636 "type": "skill",
568637 "updated_at": "2024-10-30T23:58:27.427722Z"
569638}
570639```
from line 746
677746
678747### Returns
679748
680- `id: string`
681
682 Unique identifier for the skill.
683
684 The format and length of IDs may change over time.
685
686- `type: string`
687
688 Deleted object type.
689
690 For Skills, this is always `"skill_deleted"`.
691
692 default: skill_deleted
749- `BetaDeletedSkill object`
750
751 - `id: string`
752
753 Unique identifier for the skill.
754
755 The format and length of IDs may change over time.
756
757 - `type: "skill_deleted"`
758
759 Deleted object type.
760
761 For Skills, this is always `"skill_deleted"`.
762
763 default: skill_deleted
693764
694765### Example
695766
from line 768
697768curl https://api.anthropic.com/v1/skills/$SKILL_ID \
698769 -X DELETE \
699770 -H 'anthropic-version: 2023-06-01' \
700 -H 'anthropic-beta: skills-2025-10-02' \
701771 -H "X-Api-Key: $ANTHROPIC_API_KEY"
702772```
703773
from line 776
706776```json
707777{
708778 "id": "skill_01JAbcdefghijklmnopqrstuvw",
709 "type": "type"
779 "type": "skill_deleted"
710780}
711781```
712782
713783## Domain types
714784
715### Skill Create Response
716
717- `SkillCreateResponse object`
785### Beta Deleted Skill
786
787- `BetaDeletedSkill object`
718788
719789 - `id: string`
720790
from line 792
722792
723793 The format and length of IDs may change over time.
724794
795 - `type: "skill_deleted"`
796
797 Deleted object type.
798
799 For Skills, this is always `"skill_deleted"`.
800
801 default: skill_deleted
802
803### Beta Skill
804
805- `BetaSkill object`
806
807 - `id: string`
808
809 Unique identifier for the skill.
810
811 The format and length of IDs may change over time.
812
725813 - `created_at: string`
726814
727815 ISO 8601 timestamp of when the skill was created.
728816
729 - `display_title: string or null`
730
731 Display title for the skill.
732
733 This is a human-readable label that is not included in the prompt sent to the model.
734
735 - `latest_version: string or null`
736
737 The latest version identifier for the skill.
738
739 This represents the most recent version of the skill that has been created.
740
741 - `source: string`
742
743 Source of the skill.
744
745 This may be one of the following values:
746
747 * `"custom"`: the skill was created by a user
748 * `"anthropic"`: the skill was created by Anthropic
749
750 - `type: string`
817 format: date-time
818
819 - `display_name: string`
820
821 Human-readable, single-line label for the Skill. Maximum 255 characters.
822 Always set: derived from the SKILL.md frontmatter `name` when omitted at
823 creation. Not unique.
824
825 - `latest_version_id: string`
826
827 ID of the newest Skill Version — what `latest` references resolve to. Always set: a Skill holds at least one version.
828
829 - `source: BetaSkillSource`
830
831 Where the Skill comes from.
832
833 Possible values:
834
835 * `"custom"`: authored by the platform user; private to their workspace
836 * `"anthropic"`: published by Anthropic; shared and read-only
837 * `"anthropic_example"`: Anthropic-published sample Skill
838 * `"plugin"`: resolved from an installed plugin
839
840 - `type: "custom" or "anthropic" or "anthropic_example" or "plugin"`
841
842 Where the Skill comes from.
843
844 Possible values:
845
846 * `"custom"`: authored by the platform user; private to their workspace
847 * `"anthropic"`: published by Anthropic; shared and read-only
848 * `"anthropic_example"`: Anthropic-published sample Skill
849 * `"plugin"`: resolved from an installed plugin
850
851 - `"custom"`
852
853 - `"anthropic"`
854
855 - `"anthropic_example"`
856
857 - `"plugin"`
858
859 - `type: "skill"`
751860
752861 Object type.
753862
from line 868
759868
760869 ISO 8601 timestamp of when the skill was last updated.
761870
762### Skill List Response
763
764- `SkillListResponse object`
871 format: date-time
872
873### Beta Skill Source
874
875- `BetaSkillSource object`
876
877 - `type: "custom" or "anthropic" or "anthropic_example" or "plugin"`
878
879 Where the Skill comes from.
880
881 Possible values:
882
883 * `"custom"`: authored by the platform user; private to their workspace
884 * `"anthropic"`: published by Anthropic; shared and read-only
885 * `"anthropic_example"`: Anthropic-published sample Skill
886 * `"plugin"`: resolved from an installed plugin
887
888 - `"custom"`
889
890 - `"anthropic"`
891
892 - `"anthropic_example"`
893
894 - `"plugin"`
895
896## Skills › Versions
897
898### Create Skill Version
899
900**POST** `/v1/skills/{skill_id}/versions`
901
902Create Skill Version
903
904#### Path parameters
905
906- `skill_id: string`
907
908 Unique identifier for the skill.
909
910 The format and length of IDs may change over time.
911
912#### Headers
913
914- `"anthropic-beta": optional array of AnthropicBeta`
915
916 Optional header to specify the beta version(s) you want to use.
917
918 - `string`
919
920 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
921
922 - `"message-batches-2024-09-24"`
923
924 - `"prompt-caching-2024-07-31"`
925
926 - `"computer-use-2024-10-22"`
927
928 - `"computer-use-2025-01-24"`
929
930 - `"pdfs-2024-09-25"`
931
932 - `"token-counting-2024-11-01"`
933
934 - `"token-efficient-tools-2025-02-19"`
935
936 - `"output-128k-2025-02-19"`
937
938 - `"files-api-2025-04-14"`
939
940 - `"mcp-client-2025-04-04"`
941
942 - `"mcp-client-2025-11-20"`
943
944 - `"dev-full-thinking-2025-05-14"`
945
946 - `"interleaved-thinking-2025-05-14"`
947
948 - `"code-execution-2025-05-22"`
949
950 - `"extended-cache-ttl-2025-04-11"`
951
952 - `"context-1m-2025-08-07"`
953
954 - `"context-management-2025-06-27"`
955
956 - `"model-context-window-exceeded-2025-08-26"`
957
958 - `"skills-2025-10-02"`
959
960 - `"fast-mode-2026-02-01"`
961
962 - `"output-300k-2026-03-24"`
963
964 - `"user-profiles-2026-03-24"`
965
966 - `"user-profiles-2026-08-18"`
967
968 - `"advisor-tool-2026-03-01"`
969
970 - `"managed-agents-2026-04-01"`
971
972 - `"cache-diagnosis-2026-04-07"`
973
974 - `"dreaming-2026-04-21"`
975
976 - `"thinking-token-count-2026-05-13"`
977
978 - `"server-side-fallback-2026-06-01"`
979
980 - `"server-side-fallback-2026-07-01"`
981
982 - `"fallback-credit-2026-06-01"`
983
984 - `"fallback-credit-2026-07-01"`
985
986 - `"agent-memory-2026-07-22"`
987
988 - `"mid-conversation-tool-changes-2026-07-01"`
989
990 - `"compact-2026-01-12"`
991
992 - `"computer-use-2025-11-24"`
993
994 - `"mcp-tunnels-2026-06-22"`
995
996 - `"structured-outputs-2025-11-13"`
997
998 - `"task-budgets-2026-03-13"`
999
1000 - `"thinking-display-updates-2026-08-18"`
1001
1002 - `"ce-user-management-2026-07-13"`
1003
1004#### Body parameters (form-data)
1005
1006- `files: array of string`
1007
1008 Files to upload for the skill.
1009
1010 All files must be in the same top-level directory and must include a SKILL.md file at the root of that directory.
1011
1012#### Returns
1013
1014- `BetaSkillVersion object`
7651015
7661016 - `id: string`
7671017
1018 Unique identifier for this Skill Version. The id addresses the version in
1019 paths and pins it in references.
1020
1021 - `created_at: string`
1022
1023 ISO 8601 timestamp of when the skill was created.
1024
1025 format: date-time
1026
1027 - `description: string`
1028
1029 Description of the skill version.
1030
1031 This is extracted from the SKILL.md file in the skill upload.
1032
1033 - `name: string`
1034
1035 The Skill's immutable kebab-case slug, set at creation from the first
1036 upload's SKILL.md frontmatter `name` (or its enclosing directory). Every
1037 later upload must resolve to the same value. Also the top-level directory
1038 of the Skill's mounted files and the base name of a downloaded archive.
1039
1040 - `skill_id: string`
1041
7681042 Unique identifier for the skill.
7691043
7701044 The format and length of IDs may change over time.
7711045
772 - `created_at: string`
773
774 ISO 8601 timestamp of when the skill was created.
775
776 - `display_title: string or null`
777
778 Display title for the skill.
779
780 This is a human-readable label that is not included in the prompt sent to the model.
781
782 - `latest_version: string or null`
783
784 The latest version identifier for the skill.
785
786 This represents the most recent version of the skill that has been created.
787
788 - `source: string`
789
790 Source of the skill.
791
792 This may be one of the following values:
793
794 * `"custom"`: the skill was created by a user
795 * `"anthropic"`: the skill was created by Anthropic
796
797 - `type: string`
1046 - `type: "skill_version"`
7981047
7991048 Object type.
8001049
801 For Skills, this is always `"skill"`.
802
803 default: skill
804
805 - `updated_at: string`
806
807 ISO 8601 timestamp of when the skill was last updated.
808
809### Skill Retrieve Response
810
811- `SkillRetrieveResponse object`
812
813 - `id: string`
814
815 Unique identifier for the skill.
816
817 The format and length of IDs may change over time.
818
819 - `created_at: string`
820
821 ISO 8601 timestamp of when the skill was created.
822
823 - `display_title: string or null`
824
825 Display title for the skill.
826
827 This is a human-readable label that is not included in the prompt sent to the model.
828
829 - `latest_version: string or null`
830
831 The latest version identifier for the skill.
832
833 This represents the most recent version of the skill that has been created.
834
835 - `source: string`
836
837 Source of the skill.
838
839 This may be one of the following values:
840
841 * `"custom"`: the skill was created by a user
842 * `"anthropic"`: the skill was created by Anthropic
843
844 - `type: string`
845
846 Object type.
847
848 For Skills, this is always `"skill"`.
849
850 default: skill
851
852 - `updated_at: string`
853
854 ISO 8601 timestamp of when the skill was last updated.
855
856### Skill Delete Response
857
858- `SkillDeleteResponse object`
859
860 - `id: string`
861
862 Unique identifier for the skill.
863
864 The format and length of IDs may change over time.
865
866 - `type: string`
867
868 Deleted object type.
869
870 For Skills, this is always `"skill_deleted"`.
871
872 default: skill_deleted
873
874## Skills › Versions
875
876### Create Skill Version
877
878**POST** `/v1/skills/{skill_id}/versions`
879
880Create Skill Version
881
882#### Path parameters
883
884- `skill_id: string`
885
886 Unique identifier for the skill.
887
888 The format and length of IDs may change over time.
889
890#### Headers
891
892- `"anthropic-beta": optional array of AnthropicBeta`
893
894 Optional header to specify the beta version(s) you want to use.
895
896 - `string`
897
898 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
899
900 - `"message-batches-2024-09-24"`
901
902 - `"prompt-caching-2024-07-31"`
903
904 - `"computer-use-2024-10-22"`
905
906 - `"computer-use-2025-01-24"`
907
908 - `"pdfs-2024-09-25"`
909
910 - `"token-counting-2024-11-01"`
911
912 - `"token-efficient-tools-2025-02-19"`
913
914 - `"output-128k-2025-02-19"`
915
916 - `"files-api-2025-04-14"`
917
918 - `"mcp-client-2025-04-04"`
919
920 - `"mcp-client-2025-11-20"`
921
922 - `"dev-full-thinking-2025-05-14"`
923
924 - `"interleaved-thinking-2025-05-14"`
925
926 - `"code-execution-2025-05-22"`
927
928 - `"extended-cache-ttl-2025-04-11"`
929
930 - `"context-1m-2025-08-07"`
931
932 - `"context-management-2025-06-27"`
933
934 - `"model-context-window-exceeded-2025-08-26"`
935
936 - `"skills-2025-10-02"`
937
938 - `"fast-mode-2026-02-01"`
939
940 - `"output-300k-2026-03-24"`
941
942 - `"user-profiles-2026-03-24"`
943
944 - `"user-profiles-2026-08-18"`
945
946 - `"advisor-tool-2026-03-01"`
947
948 - `"managed-agents-2026-04-01"`
949
950 - `"cache-diagnosis-2026-04-07"`
951
952 - `"dreaming-2026-04-21"`
953
954 - `"thinking-token-count-2026-05-13"`
955
956 - `"server-side-fallback-2026-06-01"`
957
958 - `"server-side-fallback-2026-07-01"`
959
960 - `"fallback-credit-2026-06-01"`
961
962 - `"fallback-credit-2026-07-01"`
963
964 - `"agent-memory-2026-07-22"`
965
966 - `"mid-conversation-tool-changes-2026-07-01"`
967
968 - `"compact-2026-01-12"`
969
970 - `"computer-use-2025-11-24"`
971
972 - `"mcp-tunnels-2026-06-22"`
973
974 - `"structured-outputs-2025-11-13"`
975
976 - `"task-budgets-2026-03-13"`
977
978 - `"thinking-display-updates-2026-08-18"`
979
980 - `"ce-user-management-2026-07-13"`
981
982#### Body parameters (form-data)
983
984- `files: array of string`
985
986 Files to upload for the skill.
987
988 All files must be in the same top-level directory and must include a SKILL.md file at the root of that directory.
989
990#### Returns
991
992- `id: string`
993
994 Unique identifier for the skill version.
995
996 The format and length of IDs may change over time.
997
998- `created_at: string`
999
1000 ISO 8601 timestamp of when the skill version was created.
1001
1002- `description: string`
1003
1004 Description of the skill version.
1005
1006 This is extracted from the SKILL.md file in the skill upload.
1007
1008- `directory: string`
1009
1010 Directory name of the skill version.
1011
1012 This is the top-level directory name that was extracted from the uploaded files.
1013
1014- `name: string`
1015
1016 Human-readable name of the skill version.
1017
1018 This is extracted from the SKILL.md file in the skill upload.
1019
1020- `skill_id: string`
1021
1022 Identifier for the skill that this version belongs to.
1023
1024- `type: string`
1025
1026 Object type.
1027
1028 For Skill Versions, this is always `"skill_version"`.
1029
1030 default: skill_version
1031
1032- `version: string`
1033
1034 Version identifier for the skill.
1035
1036 Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129").
1050 For Skill Versions, this is always `"skill_version"`.
1051
1052 default: skill_version
10371053
10381054#### Example
10391055
from line 1057
10411057curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions \
10421058 -H 'Content-Type: multipart/form-data' \
10431059 -H 'anthropic-version: 2023-06-01' \
1044 -H 'anthropic-beta: skills-2025-10-02' \
10451060 -H "X-Api-Key: $ANTHROPIC_API_KEY" \
10461061 -F files='["Example data"]'
10471062```
from line 1065
10501065
10511066```json
10521067{
1053 "id": "skillver_01JAbcdefghijklmnopqrstuvw",
1068 "id": "id",
10541069 "created_at": "2024-10-30T23:58:27.427722Z",
1055 "description": "A custom skill for doing something useful",
1056 "directory": "my-skill",
1057 "name": "my-skill",
1070 "description": "description",
1071 "name": "name",
10581072 "skill_id": "skill_01JAbcdefghijklmnopqrstuvw",
1059 "type": "type",
1060 "version": "1759178010641129"
1073 "type": "skill_version"
10611074}
10621075```
10631076
from line 1092
10791092
10801093- `limit: optional number`
10811094
1082 Number of items to return per page.
1083
1084 Defaults to `20`. Ranges from `1` to `1000`.
1095 Number of results to return per page.
1096
1097 Ranges from `1` to `1000`. Defaults to `20`.
1098
1099 default: 20, minimum: 1, maximum: 1000
10851100
10861101- `page: optional string`
10871102
from line 1196
11811196
11821197#### Returns
11831198
1184- `data: array of object`
1185
1186 List of skill versions.
1199- `data: array of BetaSkillVersion`
1200
1201 List of skills.
11871202
11881203 - `id: string`
11891204
1190 Unique identifier for the skill version.
1205 Unique identifier for this Skill Version. The id addresses the version in
1206 paths and pins it in references.
1207
1208 - `created_at: string`
1209
1210 ISO 8601 timestamp of when the skill was created.
1211
1212 format: date-time
1213
1214 - `description: string`
1215
1216 Description of the skill version.
1217
1218 This is extracted from the SKILL.md file in the skill upload.
1219
1220 - `name: string`
1221
1222 The Skill's immutable kebab-case slug, set at creation from the first
1223 upload's SKILL.md frontmatter `name` (or its enclosing directory). Every
1224 later upload must resolve to the same value. Also the top-level directory
1225 of the Skill's mounted files and the base name of a downloaded archive.
1226
1227 - `skill_id: string`
1228
1229 Unique identifier for the skill.
11911230
11921231 The format and length of IDs may change over time.
11931232
1194 - `created_at: string`
1195
1196 ISO 8601 timestamp of when the skill version was created.
1197
1198 - `description: string`
1199
1200 Description of the skill version.
1201
1202 This is extracted from the SKILL.md file in the skill upload.
1203
1204 - `directory: string`
1205
1206 Directory name of the skill version.
1207
1208 This is the top-level directory name that was extracted from the uploaded files.
1209
1210 - `name: string`
1211
1212 Human-readable name of the skill version.
1213
1214 This is extracted from the SKILL.md file in the skill upload.
1215
1216 - `skill_id: string`
1217
1218 Identifier for the skill that this version belongs to.
1219
1220 - `type: string`
1233 - `type: "skill_version"`
12211234
12221235 Object type.
12231236
from line 1238
12251238
12261239 default: skill_version
12271240
1228 - `version: string`
1229
1230 Version identifier for the skill.
1231
1232 Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129").
1233
1234- `has_more: boolean`
1235
1236 Indicates if there are more results in the requested page direction.
1237
12381241- `next_page: string or null`
12391242
1240 Token to provide in as `page` in the subsequent request to retrieve the next page of data.
1243 Token for fetching the next page of results.
1244
1245 If `null`, there are no more results available. Pass this value to the `page` parameter in the next request to get the next page.
12411246
12421247#### Example
12431248
12441249```bash
12451250curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions \
12461251 -H 'anthropic-version: 2023-06-01' \
1247 -H 'anthropic-beta: skills-2025-10-02' \
12481252 -H "X-Api-Key: $ANTHROPIC_API_KEY"
12491253```
12501254
from line 1258
12541258{
12551259 "data": [
12561260 {
1257 "id": "skillver_01JAbcdefghijklmnopqrstuvw",
1261 "id": "id",
12581262 "created_at": "2024-10-30T23:58:27.427722Z",
1259 "description": "A custom skill for doing something useful",
1260 "directory": "my-skill",
1261 "name": "my-skill",
1263 "description": "description",
1264 "name": "name",
12621265 "skill_id": "skill_01JAbcdefghijklmnopqrstuvw",
1263 "type": "type",
1264 "version": "1759178010641129"
1266 "type": "skill_version"
12651267 }
12661268 ],
1267 "has_more": true,
1268 "next_page": "page_MjAyNS0wNS0xNFQwMDowMDowMFo="
1269 "next_page": "next_page"
12691270}
12701271```
12711272
from line 1286
12851286
12861287- `version: string`
12871288
1288 Version identifier for the skill.
1289
1290 Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129").
1289 Identifies the skill version by its version ID.
1290
1291 Requests carrying the `skills-2025-10-02` beta header address versions by their Unix epoch timestamp instead (e.g., "1759178010641129").
12911292
12921293#### Headers
12931294
from line 1387
13861387```bash
13871388curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions/$VERSION/content \
13881389 -H 'anthropic-version: 2023-06-01' \
1389 -H 'anthropic-beta: skills-2025-10-02' \
13901390 -H "X-Api-Key: $ANTHROPIC_API_KEY"
13911391```
13921392
from line 1406
14061406
14071407- `version: string`
14081408
1409 Version identifier for the skill.
1410
1411 Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129").
1409 Identifies the skill version: a version ID, or the literal `latest` for the skill's most recent version.
1410
1411 Requests carrying the `skills-2025-10-02` beta header address versions by their Unix epoch timestamp instead (e.g., "1759178010641129").
14121412
14131413#### Headers
14141414
from line 1504
15041504
15051505#### Returns
15061506
1507- `id: string`
1508
1509 Unique identifier for the skill version.
1510
1511 The format and length of IDs may change over time.
1512
1513- `created_at: string`
1514
1515 ISO 8601 timestamp of when the skill version was created.
1516
1517- `description: string`
1518
1519 Description of the skill version.
1520
1521 This is extracted from the SKILL.md file in the skill upload.
1522
1523- `directory: string`
1524
1525 Directory name of the skill version.
1526
1527 This is the top-level directory name that was extracted from the uploaded files.
1528
1529- `name: string`
1530
1531 Human-readable name of the skill version.
1532
1533 This is extracted from the SKILL.md file in the skill upload.
1534
1535- `skill_id: string`
1536
1537 Identifier for the skill that this version belongs to.
1538
1539- `type: string`
1540
1541 Object type.
1542
1543 For Skill Versions, this is always `"skill_version"`.
1544
1545 default: skill_version
1546
1547- `version: string`
1548
1549 Version identifier for the skill.
1550
1551 Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129").
1507- `BetaSkillVersion object`
1508
1509 - `id: string`
1510
1511 Unique identifier for this Skill Version. The id addresses the version in
1512 paths and pins it in references.
1513
1514 - `created_at: string`
1515
1516 ISO 8601 timestamp of when the skill was created.
1517
1518 format: date-time
1519
1520 - `description: string`
1521
1522 Description of the skill version.
1523
1524 This is extracted from the SKILL.md file in the skill upload.
1525
1526 - `name: string`
1527
1528 The Skill's immutable kebab-case slug, set at creation from the first
1529 upload's SKILL.md frontmatter `name` (or its enclosing directory). Every
1530 later upload must resolve to the same value. Also the top-level directory
1531 of the Skill's mounted files and the base name of a downloaded archive.
1532
1533 - `skill_id: string`
1534
1535 Unique identifier for the skill.
1536
1537 The format and length of IDs may change over time.
1538
1539 - `type: "skill_version"`
1540
1541 Object type.
1542
1543 For Skill Versions, this is always `"skill_version"`.
1544
1545 default: skill_version
15521546
15531547#### Example
15541548
15551549```bash
15561550curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions/$VERSION \
15571551 -H 'anthropic-version: 2023-06-01' \
1558 -H 'anthropic-beta: skills-2025-10-02' \
15591552 -H "X-Api-Key: $ANTHROPIC_API_KEY"
15601553```
15611554
from line 1556
15631556
15641557```json
15651558{
1566 "id": "skillver_01JAbcdefghijklmnopqrstuvw",
1559 "id": "id",
15671560 "created_at": "2024-10-30T23:58:27.427722Z",
1568 "description": "A custom skill for doing something useful",
1569 "directory": "my-skill",
1570 "name": "my-skill",
1561 "description": "description",
1562 "name": "name",
15711563 "skill_id": "skill_01JAbcdefghijklmnopqrstuvw",
1572 "type": "type",
1573 "version": "1759178010641129"
1564 "type": "skill_version"
15741565}
15751566```
15761567
from line 1581
15901581
15911582- `version: string`
15921583
1593 Version identifier for the skill.
1594
1595 Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129").
1584 Identifies the skill version by its version ID.
1585
1586 Requests carrying the `skills-2025-10-02` beta header address versions by their Unix epoch timestamp instead (e.g., "1759178010641129").
15961587
15971588#### Headers
15981589
from line 1679
16881679
16891680#### Returns
16901681
1691- `id: string`
1692
1693 Version identifier for the skill.
1694
1695 Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129").
1696
1697- `type: string`
1698
1699 Deleted object type.
1700
1701 For Skill Versions, this is always `"skill_version_deleted"`.
1702
1703 default: skill_version_deleted
1682- `BetaDeletedSkillVersion object`
1683
1684 - `id: string`
1685
1686 Unique identifier for this Skill Version. The id addresses the version in
1687 paths and pins it in references.
1688
1689 - `type: "skill_version_deleted"`
1690
1691 Deleted object type.
1692
1693 For Skill Versions, this is always `"skill_version_deleted"`.
1694
1695 default: skill_version_deleted
17041696
17051697#### Example
17061698
from line 1700
17081700curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions/$VERSION \
17091701 -X DELETE \
17101702 -H 'anthropic-version: 2023-06-01' \
1711 -H 'anthropic-beta: skills-2025-10-02' \
17121703 -H "X-Api-Key: $ANTHROPIC_API_KEY"
17131704```
17141705
from line 1707
17161707
17171708```json
17181709{
1719 "id": "1759178010641129",
1720 "type": "type"
1710 "id": "id",
1711 "type": "skill_version_deleted"
17211712}
17221713```
17231714