Repository Public
1---2title: Versions3url: https://platform.claude.com/docs/en/api/beta/skills/versions4---56# Versions78## Create Skill Version910**POST** `/v1/skills/{skill_id}/versions`1112Create Skill Version1314### Path parameters1516- `skill_id: string`1718 Unique identifier for the skill.1920 The format and length of IDs may change over time.2122### Headers2324- `"anthropic-beta": optional array of AnthropicBeta`2526 Optional header to specify the beta version(s) you want to use.2728 - `string`2930 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 43 more`3132 - `"message-batches-2024-09-24"`3334 - `"prompt-caching-2024-07-31"`3536 - `"computer-use-2024-10-22"`3738 - `"computer-use-2025-01-24"`3940 - `"pdfs-2024-09-25"`4142 - `"token-counting-2024-11-01"`4344 - `"token-efficient-tools-2025-02-19"`4546 - `"output-128k-2025-02-19"`4748 - `"files-api-2025-04-14"`4950 - `"mcp-client-2025-04-04"`5152 - `"mcp-client-2025-11-20"`5354 - `"dev-full-thinking-2025-05-14"`5556 - `"interleaved-thinking-2025-05-14"`5758 - `"code-execution-2025-05-22"`5960 - `"extended-cache-ttl-2025-04-11"`6162 - `"context-1m-2025-08-07"`6364 - `"context-management-2025-06-27"`6566 - `"model-context-window-exceeded-2025-08-26"`6768 - `"skills-2025-10-02"`6970 - `"fast-mode-2026-02-01"`7172 - `"output-300k-2026-03-24"`7374 - `"user-profiles-2026-03-24"`7576 - `"user-profiles-2026-08-18"`7778 - `"user-profiles-2026-09-04"`7980 - `"advisor-tool-2026-03-01"`8182 - `"managed-agents-2026-04-01"`8384 - `"cache-diagnosis-2026-04-07"`8586 - `"dreaming-2026-04-21"`8788 - `"thinking-token-count-2026-05-13"`8990 - `"server-side-fallback-2026-06-01"`9192 - `"server-side-fallback-2026-07-01"`9394 - `"fallback-credit-2026-06-01"`9596 - `"fallback-credit-2026-07-01"`9798 - `"agent-memory-2026-07-22"`99100 - `"mid-conversation-tool-changes-2026-07-01"`101102 - `"compact-2026-01-12"`103104 - `"computer-use-2025-11-24"`105106 - `"mcp-tunnels-2026-06-22"`107108 - `"structured-outputs-2025-11-13"`109110 - `"task-budgets-2026-03-13"`111112 - `"thinking-display-updates-2026-08-18"`113114 - `"ce-user-management-2026-07-13"`115116 - `"mid-conversation-output-config-2026-07-01"`117118 - `"thinking-binding-controls-2026-08-01"`119120 - `"mid-conversation-system-clear-at-2026-08-21"`121122 - `"compact-2026-09-04"`123124- `"anthropic-workspace-id": optional string`125126### Body parameters (form-data)127128- `files: array of string`129130 Files to upload for the skill.131132 All files must be in the same top-level directory and must include a SKILL.md file at the root of that directory.133134### Returns135136- `BetaSkillVersion object`137138 - `type: "skill_version"`139140 Object type.141142 For Skill Versions, this is always `"skill_version"`.143144 default: skill_version145146 - `id: string`147148 Unique identifier for this Skill Version. The id addresses the version in149 paths and pins it in references.150151 - `created_at: string`152153 ISO 8601 timestamp of when the skill was created.154155 format: date-time156157 - `description: string`158159 Description of the skill version.160161 This is extracted from the SKILL.md file in the skill upload.162163 - `name: string`164165 The Skill's immutable kebab-case slug, set at creation from the first166 upload's SKILL.md frontmatter `name` (or its enclosing directory). Every167 later upload must resolve to the same value. Also the top-level directory168 of the Skill's mounted files and the base name of a downloaded archive.169170 - `skill_id: string`171172 Unique identifier for the skill.173174 The format and length of IDs may change over time.175176### Example177178```bash179curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions \180 -H 'Content-Type: multipart/form-data' \181 -H 'anthropic-version: 2023-06-01' \182 -H "X-Api-Key: $ANTHROPIC_API_KEY" \183 -F 'files[]=@/path/to/file'184```185186#### Response (200)187188```json189{190 "id": "id",191 "created_at": "2024-10-30T23:58:27.427722Z",192 "description": "description",193 "name": "name",194 "skill_id": "skill_01JAbcdefghijklmnopqrstuvw",195 "type": "skill_version"196}197```198199## List Skill Versions200201**GET** `/v1/skills/{skill_id}/versions`202203List Skill Versions204205### Path parameters206207- `skill_id: string`208209 Unique identifier for the skill.210211 The format and length of IDs may change over time.212213### Query parameters214215- `limit: optional number`216217 Number of results to return per page.218219 Ranges from `1` to `1000`. Defaults to `20`.220221 default: 20, minimum: 1, maximum: 1000222223- `page: optional string`224225 Optionally set to the `next_page` token from the previous response.226227### Headers228229- `"anthropic-beta": optional array of AnthropicBeta`230231 Optional header to specify the beta version(s) you want to use.232233 - `string`234235 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 43 more`236237 - `"message-batches-2024-09-24"`238239 - `"prompt-caching-2024-07-31"`240241 - `"computer-use-2024-10-22"`242243 - `"computer-use-2025-01-24"`244245 - `"pdfs-2024-09-25"`246247 - `"token-counting-2024-11-01"`248249 - `"token-efficient-tools-2025-02-19"`250251 - `"output-128k-2025-02-19"`252253 - `"files-api-2025-04-14"`254255 - `"mcp-client-2025-04-04"`256257 - `"mcp-client-2025-11-20"`258259 - `"dev-full-thinking-2025-05-14"`260261 - `"interleaved-thinking-2025-05-14"`262263 - `"code-execution-2025-05-22"`264265 - `"extended-cache-ttl-2025-04-11"`266267 - `"context-1m-2025-08-07"`268269 - `"context-management-2025-06-27"`270271 - `"model-context-window-exceeded-2025-08-26"`272273 - `"skills-2025-10-02"`274275 - `"fast-mode-2026-02-01"`276277 - `"output-300k-2026-03-24"`278279 - `"user-profiles-2026-03-24"`280281 - `"user-profiles-2026-08-18"`282283 - `"user-profiles-2026-09-04"`284285 - `"advisor-tool-2026-03-01"`286287 - `"managed-agents-2026-04-01"`288289 - `"cache-diagnosis-2026-04-07"`290291 - `"dreaming-2026-04-21"`292293 - `"thinking-token-count-2026-05-13"`294295 - `"server-side-fallback-2026-06-01"`296297 - `"server-side-fallback-2026-07-01"`298299 - `"fallback-credit-2026-06-01"`300301 - `"fallback-credit-2026-07-01"`302303 - `"agent-memory-2026-07-22"`304305 - `"mid-conversation-tool-changes-2026-07-01"`306307 - `"compact-2026-01-12"`308309 - `"computer-use-2025-11-24"`310311 - `"mcp-tunnels-2026-06-22"`312313 - `"structured-outputs-2025-11-13"`314315 - `"task-budgets-2026-03-13"`316317 - `"thinking-display-updates-2026-08-18"`318319 - `"ce-user-management-2026-07-13"`320321 - `"mid-conversation-output-config-2026-07-01"`322323 - `"thinking-binding-controls-2026-08-01"`324325 - `"mid-conversation-system-clear-at-2026-08-21"`326327 - `"compact-2026-09-04"`328329- `"anthropic-workspace-id": optional string`330331### Returns332333- `data: array of BetaSkillVersion`334335 List of skills.336337 - `type: "skill_version"`338339 Object type.340341 For Skill Versions, this is always `"skill_version"`.342343 default: skill_version344345 - `id: string`346347 Unique identifier for this Skill Version. The id addresses the version in348 paths and pins it in references.349350 - `created_at: string`351352 ISO 8601 timestamp of when the skill was created.353354 format: date-time355356 - `description: string`357358 Description of the skill version.359360 This is extracted from the SKILL.md file in the skill upload.361362 - `name: string`363364 The Skill's immutable kebab-case slug, set at creation from the first365 upload's SKILL.md frontmatter `name` (or its enclosing directory). Every366 later upload must resolve to the same value. Also the top-level directory367 of the Skill's mounted files and the base name of a downloaded archive.368369 - `skill_id: string`370371 Unique identifier for the skill.372373 The format and length of IDs may change over time.374375- `next_page: string or null`376377 Token for fetching the next page of results.378379 If `null`, there are no more results available. Pass this value to the `page` parameter in the next request to get the next page.380381### Example382383```bash384curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions \385 -H 'anthropic-version: 2023-06-01' \386 -H "X-Api-Key: $ANTHROPIC_API_KEY"387```388389#### Response (200)390391```json392{393 "data": [394 {395 "id": "id",396 "created_at": "2024-10-30T23:58:27.427722Z",397 "description": "description",398 "name": "name",399 "skill_id": "skill_01JAbcdefghijklmnopqrstuvw",400 "type": "skill_version"401 }402 ],403 "next_page": "next_page"404}405```406407## Download Skill Version Content408409**GET** `/v1/skills/{skill_id}/versions/{version}/content`410411Download a skill version's content as a zip archive.412413### Path parameters414415- `skill_id: string`416417 Unique identifier for the skill.418419 The format and length of IDs may change over time.420421- `version: string`422423 Identifies the skill version by its version ID.424425 Requests carrying the `skills-2025-10-02` beta header address versions by their Unix epoch timestamp instead (e.g., "1759178010641129").426427### Headers428429- `"anthropic-beta": optional array of AnthropicBeta`430431 Optional header to specify the beta version(s) you want to use.432433 - `string`434435 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 43 more`436437 - `"message-batches-2024-09-24"`438439 - `"prompt-caching-2024-07-31"`440441 - `"computer-use-2024-10-22"`442443 - `"computer-use-2025-01-24"`444445 - `"pdfs-2024-09-25"`446447 - `"token-counting-2024-11-01"`448449 - `"token-efficient-tools-2025-02-19"`450451 - `"output-128k-2025-02-19"`452453 - `"files-api-2025-04-14"`454455 - `"mcp-client-2025-04-04"`456457 - `"mcp-client-2025-11-20"`458459 - `"dev-full-thinking-2025-05-14"`460461 - `"interleaved-thinking-2025-05-14"`462463 - `"code-execution-2025-05-22"`464465 - `"extended-cache-ttl-2025-04-11"`466467 - `"context-1m-2025-08-07"`468469 - `"context-management-2025-06-27"`470471 - `"model-context-window-exceeded-2025-08-26"`472473 - `"skills-2025-10-02"`474475 - `"fast-mode-2026-02-01"`476477 - `"output-300k-2026-03-24"`478479 - `"user-profiles-2026-03-24"`480481 - `"user-profiles-2026-08-18"`482483 - `"user-profiles-2026-09-04"`484485 - `"advisor-tool-2026-03-01"`486487 - `"managed-agents-2026-04-01"`488489 - `"cache-diagnosis-2026-04-07"`490491 - `"dreaming-2026-04-21"`492493 - `"thinking-token-count-2026-05-13"`494495 - `"server-side-fallback-2026-06-01"`496497 - `"server-side-fallback-2026-07-01"`498499 - `"fallback-credit-2026-06-01"`500501 - `"fallback-credit-2026-07-01"`502503 - `"agent-memory-2026-07-22"`504505 - `"mid-conversation-tool-changes-2026-07-01"`506507 - `"compact-2026-01-12"`508509 - `"computer-use-2025-11-24"`510511 - `"mcp-tunnels-2026-06-22"`512513 - `"structured-outputs-2025-11-13"`514515 - `"task-budgets-2026-03-13"`516517 - `"thinking-display-updates-2026-08-18"`518519 - `"ce-user-management-2026-07-13"`520521 - `"mid-conversation-output-config-2026-07-01"`522523 - `"thinking-binding-controls-2026-08-01"`524525 - `"mid-conversation-system-clear-at-2026-08-21"`526527 - `"compact-2026-09-04"`528529- `"anthropic-workspace-id": optional string`530531### Example532533```bash534curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions/$VERSION/content \535 -H 'anthropic-version: 2023-06-01' \536 -H "X-Api-Key: $ANTHROPIC_API_KEY"537```538539## Get Skill Version540541**GET** `/v1/skills/{skill_id}/versions/{version}`542543Get Skill Version544545### Path parameters546547- `skill_id: string`548549 Unique identifier for the skill.550551 The format and length of IDs may change over time.552553- `version: string`554555 Identifies the skill version: a version ID, or the literal `latest` for the skill's most recent version.556557 Requests carrying the `skills-2025-10-02` beta header address versions by their Unix epoch timestamp instead (e.g., "1759178010641129").558559### Headers560561- `"anthropic-beta": optional array of AnthropicBeta`562563 Optional header to specify the beta version(s) you want to use.564565 - `string`566567 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 43 more`568569 - `"message-batches-2024-09-24"`570571 - `"prompt-caching-2024-07-31"`572573 - `"computer-use-2024-10-22"`574575 - `"computer-use-2025-01-24"`576577 - `"pdfs-2024-09-25"`578579 - `"token-counting-2024-11-01"`580581 - `"token-efficient-tools-2025-02-19"`582583 - `"output-128k-2025-02-19"`584585 - `"files-api-2025-04-14"`586587 - `"mcp-client-2025-04-04"`588589 - `"mcp-client-2025-11-20"`590591 - `"dev-full-thinking-2025-05-14"`592593 - `"interleaved-thinking-2025-05-14"`594595 - `"code-execution-2025-05-22"`596597 - `"extended-cache-ttl-2025-04-11"`598599 - `"context-1m-2025-08-07"`600601 - `"context-management-2025-06-27"`602603 - `"model-context-window-exceeded-2025-08-26"`604605 - `"skills-2025-10-02"`606607 - `"fast-mode-2026-02-01"`608609 - `"output-300k-2026-03-24"`610611 - `"user-profiles-2026-03-24"`612613 - `"user-profiles-2026-08-18"`614615 - `"user-profiles-2026-09-04"`616617 - `"advisor-tool-2026-03-01"`618619 - `"managed-agents-2026-04-01"`620621 - `"cache-diagnosis-2026-04-07"`622623 - `"dreaming-2026-04-21"`624625 - `"thinking-token-count-2026-05-13"`626627 - `"server-side-fallback-2026-06-01"`628629 - `"server-side-fallback-2026-07-01"`630631 - `"fallback-credit-2026-06-01"`632633 - `"fallback-credit-2026-07-01"`634635 - `"agent-memory-2026-07-22"`636637 - `"mid-conversation-tool-changes-2026-07-01"`638639 - `"compact-2026-01-12"`640641 - `"computer-use-2025-11-24"`642643 - `"mcp-tunnels-2026-06-22"`644645 - `"structured-outputs-2025-11-13"`646647 - `"task-budgets-2026-03-13"`648649 - `"thinking-display-updates-2026-08-18"`650651 - `"ce-user-management-2026-07-13"`652653 - `"mid-conversation-output-config-2026-07-01"`654655 - `"thinking-binding-controls-2026-08-01"`656657 - `"mid-conversation-system-clear-at-2026-08-21"`658659 - `"compact-2026-09-04"`660661- `"anthropic-workspace-id": optional string`662663### Returns664665- `BetaSkillVersion object`666667 - `type: "skill_version"`668669 Object type.670671 For Skill Versions, this is always `"skill_version"`.672673 default: skill_version674675 - `id: string`676677 Unique identifier for this Skill Version. The id addresses the version in678 paths and pins it in references.679680 - `created_at: string`681682 ISO 8601 timestamp of when the skill was created.683684 format: date-time685686 - `description: string`687688 Description of the skill version.689690 This is extracted from the SKILL.md file in the skill upload.691692 - `name: string`693694 The Skill's immutable kebab-case slug, set at creation from the first695 upload's SKILL.md frontmatter `name` (or its enclosing directory). Every696 later upload must resolve to the same value. Also the top-level directory697 of the Skill's mounted files and the base name of a downloaded archive.698699 - `skill_id: string`700701 Unique identifier for the skill.702703 The format and length of IDs may change over time.704705### Example706707```bash708curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions/$VERSION \709 -H 'anthropic-version: 2023-06-01' \710 -H "X-Api-Key: $ANTHROPIC_API_KEY"711```712713#### Response (200)714715```json716{717 "id": "id",718 "created_at": "2024-10-30T23:58:27.427722Z",719 "description": "description",720 "name": "name",721 "skill_id": "skill_01JAbcdefghijklmnopqrstuvw",722 "type": "skill_version"723}724```725726## Delete Skill Version727728**DELETE** `/v1/skills/{skill_id}/versions/{version}`729730Delete Skill Version731732### Path parameters733734- `skill_id: string`735736 Unique identifier for the skill.737738 The format and length of IDs may change over time.739740- `version: string`741742 Identifies the skill version by its version ID.743744 Requests carrying the `skills-2025-10-02` beta header address versions by their Unix epoch timestamp instead (e.g., "1759178010641129").745746### Headers747748- `"anthropic-beta": optional array of AnthropicBeta`749750 Optional header to specify the beta version(s) you want to use.751752 - `string`753754 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 43 more`755756 - `"message-batches-2024-09-24"`757758 - `"prompt-caching-2024-07-31"`759760 - `"computer-use-2024-10-22"`761762 - `"computer-use-2025-01-24"`763764 - `"pdfs-2024-09-25"`765766 - `"token-counting-2024-11-01"`767768 - `"token-efficient-tools-2025-02-19"`769770 - `"output-128k-2025-02-19"`771772 - `"files-api-2025-04-14"`773774 - `"mcp-client-2025-04-04"`775776 - `"mcp-client-2025-11-20"`777778 - `"dev-full-thinking-2025-05-14"`779780 - `"interleaved-thinking-2025-05-14"`781782 - `"code-execution-2025-05-22"`783784 - `"extended-cache-ttl-2025-04-11"`785786 - `"context-1m-2025-08-07"`787788 - `"context-management-2025-06-27"`789790 - `"model-context-window-exceeded-2025-08-26"`791792 - `"skills-2025-10-02"`793794 - `"fast-mode-2026-02-01"`795796 - `"output-300k-2026-03-24"`797798 - `"user-profiles-2026-03-24"`799800 - `"user-profiles-2026-08-18"`801802 - `"user-profiles-2026-09-04"`803804 - `"advisor-tool-2026-03-01"`805806 - `"managed-agents-2026-04-01"`807808 - `"cache-diagnosis-2026-04-07"`809810 - `"dreaming-2026-04-21"`811812 - `"thinking-token-count-2026-05-13"`813814 - `"server-side-fallback-2026-06-01"`815816 - `"server-side-fallback-2026-07-01"`817818 - `"fallback-credit-2026-06-01"`819820 - `"fallback-credit-2026-07-01"`821822 - `"agent-memory-2026-07-22"`823824 - `"mid-conversation-tool-changes-2026-07-01"`825826 - `"compact-2026-01-12"`827828 - `"computer-use-2025-11-24"`829830 - `"mcp-tunnels-2026-06-22"`831832 - `"structured-outputs-2025-11-13"`833834 - `"task-budgets-2026-03-13"`835836 - `"thinking-display-updates-2026-08-18"`837838 - `"ce-user-management-2026-07-13"`839840 - `"mid-conversation-output-config-2026-07-01"`841842 - `"thinking-binding-controls-2026-08-01"`843844 - `"mid-conversation-system-clear-at-2026-08-21"`845846 - `"compact-2026-09-04"`847848- `"anthropic-workspace-id": optional string`849850### Returns851852- `BetaDeletedSkillVersion object`853854 - `type: "skill_version_deleted"`855856 Deleted object type.857858 For Skill Versions, this is always `"skill_version_deleted"`.859860 default: skill_version_deleted861862 - `id: string`863864 Unique identifier for this Skill Version. The id addresses the version in865 paths and pins it in references.866867### Example868869```bash870curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions/$VERSION \871 -X DELETE \872 -H 'anthropic-version: 2023-06-01' \873 -H "X-Api-Key: $ANTHROPIC_API_KEY"874```875876#### Response (200)877878```json879{880 "id": "id",881 "type": "skill_version_deleted"882}883```884885## Domain types886887### Beta Deleted Skill Version888889- `BetaDeletedSkillVersion object`890891 - `type: "skill_version_deleted"`892893 Deleted object type.894895 For Skill Versions, this is always `"skill_version_deleted"`.896897 default: skill_version_deleted898899 - `id: string`900901 Unique identifier for this Skill Version. The id addresses the version in902 paths and pins it in references.903904### Beta Skill Version905906- `BetaSkillVersion object`907908 - `type: "skill_version"`909910 Object type.911912 For Skill Versions, this is always `"skill_version"`.913914 default: skill_version915916 - `id: string`917918 Unique identifier for this Skill Version. The id addresses the version in919 paths and pins it in references.920921 - `created_at: string`922923 ISO 8601 timestamp of when the skill was created.924925 format: date-time926927 - `description: string`928929 Description of the skill version.930931 This is extracted from the SKILL.md file in the skill upload.932933 - `name: string`934935 The Skill's immutable kebab-case slug, set at creation from the first936 upload's SKILL.md frontmatter `name` (or its enclosing directory). Every937 later upload must resolve to the same value. Also the top-level directory938 of the Skill's mounted files and the base name of a downloaded archive.939940 - `skill_id: string`941942 Unique identifier for the skill.943944 The format and length of IDs may change over time.945