The whole hunk
from line 1, old and new numbered
/
lines
from line 1
1---
2title: Versions
3url: https://platform.claude.com/docs/en/api/beta/skills/versions
4---
5
16# Versions
27
38## Create Skill Version
from line 27
2227
2328 - `string`
2429
25 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
30 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
2631
2732 - `"message-batches-2024-09-24"`
2833
from line 75
7075
7176 - `"user-profiles-2026-08-18"`
7277
78 - `"user-profiles-2026-09-04"`
79
7380 - `"advisor-tool-2026-03-01"`
7481
7582 - `"managed-agents-2026-04-01"`
from line 119
112119
113120 - `"mid-conversation-system-clear-at-2026-08-21"`
114121
122- `"anthropic-workspace-id": optional string`
123
115124### Body parameters (form-data)
116125
117126- `files: array of string`
from line 133
124133
125134- `BetaSkillVersion object`
126135
136 - `type: "skill_version"`
137
138 Object type.
139
140 For Skill Versions, this is always `"skill_version"`.
141
142 default: skill_version
143
127144 - `id: string`
128145
129146 Unique identifier for this Skill Version. The id addresses the version in
from line 171
154171
155172 The format and length of IDs may change over time.
156173
157 - `type: "skill_version"`
158
159 Object type.
160
161 For Skill Versions, this is always `"skill_version"`.
162
163 default: skill_version
164
165174### Example
166175
167176```bash
from line 230
221230
222231 - `string`
223232
224 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
233 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
225234
226235 - `"message-batches-2024-09-24"`
227236
from line 278
269278
270279 - `"user-profiles-2026-08-18"`
271280
281 - `"user-profiles-2026-09-04"`
282
272283 - `"advisor-tool-2026-03-01"`
273284
274285 - `"managed-agents-2026-04-01"`
from line 322
311322
312323 - `"mid-conversation-system-clear-at-2026-08-21"`
313324
325- `"anthropic-workspace-id": optional string`
326
314327### Returns
315328
316329- `data: array of BetaSkillVersion`
from line 330
317330
318331 List of skills.
319332
333 - `type: "skill_version"`
334
335 Object type.
336
337 For Skill Versions, this is always `"skill_version"`.
338
339 default: skill_version
340
320341 - `id: string`
321342
322343 Unique identifier for this Skill Version. The id addresses the version in
from line 368
347368
348369 The format and length of IDs may change over time.
349370
350 - `type: "skill_version"`
351
352 Object type.
353
354 For Skill Versions, this is always `"skill_version"`.
355
356 default: skill_version
357
358371- `next_page: string or null`
359372
360373 Token for fetching the next page of results.
from line 428
415428
416429 - `string`
417430
418 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
431 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
419432
420433 - `"message-batches-2024-09-24"`
421434
from line 476
463476
464477 - `"user-profiles-2026-08-18"`
465478
479 - `"user-profiles-2026-09-04"`
480
466481 - `"advisor-tool-2026-03-01"`
467482
468483 - `"managed-agents-2026-04-01"`
from line 520
505520
506521 - `"mid-conversation-system-clear-at-2026-08-21"`
507522
523- `"anthropic-workspace-id": optional string`
524
508525### Example
509526
510527```bash
from line 558
541558
542559 - `string`
543560
544 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
561 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
545562
546563 - `"message-batches-2024-09-24"`
547564
from line 606
589606
590607 - `"user-profiles-2026-08-18"`
591608
609 - `"user-profiles-2026-09-04"`
610
592611 - `"advisor-tool-2026-03-01"`
593612
594613 - `"managed-agents-2026-04-01"`
from line 650
631650
632651 - `"mid-conversation-system-clear-at-2026-08-21"`
633652
653- `"anthropic-workspace-id": optional string`
654
634655### Returns
635656
636657- `BetaSkillVersion object`
637658
659 - `type: "skill_version"`
660
661 Object type.
662
663 For Skill Versions, this is always `"skill_version"`.
664
665 default: skill_version
666
638667 - `id: string`
639668
640669 Unique identifier for this Skill Version. The id addresses the version in
from line 694
665694
666695 The format and length of IDs may change over time.
667696
668 - `type: "skill_version"`
669
670 Object type.
671
672 For Skill Versions, this is always `"skill_version"`.
673
674 default: skill_version
675
676697### Example
677698
678699```bash
from line 743
722743
723744 - `string`
724745
725 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
746 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
726747
727748 - `"message-batches-2024-09-24"`
728749
from line 791
770791
771792 - `"user-profiles-2026-08-18"`
772793
794 - `"user-profiles-2026-09-04"`
795
773796 - `"advisor-tool-2026-03-01"`
774797
775798 - `"managed-agents-2026-04-01"`
from line 835
812835
813836 - `"mid-conversation-system-clear-at-2026-08-21"`
814837
838- `"anthropic-workspace-id": optional string`
839
815840### Returns
816841
817842- `BetaDeletedSkillVersion object`
818843
819 - `id: string`
820
821 Unique identifier for this Skill Version. The id addresses the version in
822 paths and pins it in references.
823
824844 - `type: "skill_version_deleted"`
825845
826846 Deleted object type.
from line 849
829849
830850 default: skill_version_deleted
831851
852 - `id: string`
853
854 Unique identifier for this Skill Version. The id addresses the version in
855 paths and pins it in references.
856
832857### Example
833858
834859```bash
from line 878
853878
854879- `BetaDeletedSkillVersion object`
855880
856 - `id: string`
857
858 Unique identifier for this Skill Version. The id addresses the version in
859 paths and pins it in references.
860
861881 - `type: "skill_version_deleted"`
862882
863883 Deleted object type.
from line 886
866886
867887 default: skill_version_deleted
868888
889 - `id: string`
890
891 Unique identifier for this Skill Version. The id addresses the version in
892 paths and pins it in references.
893
869894### Beta Skill Version
870895
871896- `BetaSkillVersion object`
872897
898 - `type: "skill_version"`
899
900 Object type.
901
902 For Skill Versions, this is always `"skill_version"`.
903
904 default: skill_version
905
873906 - `id: string`
874907
875908 Unique identifier for this Skill Version. The id addresses the version in
from line 932
899932 Unique identifier for the skill.
900933
901934 The format and length of IDs may change over time.
902
903 - `type: "skill_version"`
904
905 Object type.
906
907 For Skill Versions, this is always `"skill_version"`.
908
909 default: skill_version
910935