1---2title: Skills3url: https://platform.claude.com/docs/en/api/beta/skills4---56# Skills78## Create Skill910**POST** `/v1/skills`1112Create Skill1314### Headers1516- `"anthropic-beta": optional array of AnthropicBeta`1718 Optional header to specify the beta version(s) you want to use.1920 - `string`2122 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 43 more`2324 - `"message-batches-2024-09-24"`2526 - `"prompt-caching-2024-07-31"`2728 - `"computer-use-2024-10-22"`2930 - `"computer-use-2025-01-24"`3132 - `"pdfs-2024-09-25"`3334 - `"token-counting-2024-11-01"`3536 - `"token-efficient-tools-2025-02-19"`3738 - `"output-128k-2025-02-19"`3940 - `"files-api-2025-04-14"`4142 - `"mcp-client-2025-04-04"`4344 - `"mcp-client-2025-11-20"`4546 - `"dev-full-thinking-2025-05-14"`4748 - `"interleaved-thinking-2025-05-14"`4950 - `"code-execution-2025-05-22"`5152 - `"extended-cache-ttl-2025-04-11"`5354 - `"context-1m-2025-08-07"`5556 - `"context-management-2025-06-27"`5758 - `"model-context-window-exceeded-2025-08-26"`5960 - `"skills-2025-10-02"`6162 - `"fast-mode-2026-02-01"`6364 - `"output-300k-2026-03-24"`6566 - `"user-profiles-2026-03-24"`6768 - `"user-profiles-2026-08-18"`6970 - `"user-profiles-2026-09-04"`7172 - `"advisor-tool-2026-03-01"`7374 - `"managed-agents-2026-04-01"`7576 - `"cache-diagnosis-2026-04-07"`7778 - `"dreaming-2026-04-21"`7980 - `"thinking-token-count-2026-05-13"`8182 - `"server-side-fallback-2026-06-01"`8384 - `"server-side-fallback-2026-07-01"`8586 - `"fallback-credit-2026-06-01"`8788 - `"fallback-credit-2026-07-01"`8990 - `"agent-memory-2026-07-22"`9192 - `"mid-conversation-tool-changes-2026-07-01"`9394 - `"compact-2026-01-12"`9596 - `"computer-use-2025-11-24"`9798 - `"mcp-tunnels-2026-06-22"`99100 - `"structured-outputs-2025-11-13"`101102 - `"task-budgets-2026-03-13"`103104 - `"thinking-display-updates-2026-08-18"`105106 - `"ce-user-management-2026-07-13"`107108 - `"mid-conversation-output-config-2026-07-01"`109110 - `"thinking-binding-controls-2026-08-01"`111112 - `"mid-conversation-system-clear-at-2026-08-21"`113114 - `"compact-2026-09-04"`115116- `"anthropic-workspace-id": optional string`117118### Body parameters (form-data)119120- `files: array of string`121122 Files to upload for the skill.123124 All files must be in the same top-level directory and must include a SKILL.md file at the root of that directory.125126- `display_name: optional string or null`127128 Human-readable, single-line label for the Skill. Maximum 255 characters.129 Always set: derived from the SKILL.md frontmatter `name` when omitted at130 creation. Not unique.131132### Returns133134- `BetaSkill object`135136 - `type: "skill"`137138 Object type.139140 For Skills, this is always `"skill"`.141142 default: skill143144 - `id: string`145146 Unique identifier for the skill.147148 The format and length of IDs may change over time.149150 - `created_at: string`151152 ISO 8601 timestamp of when the skill was created.153154 format: date-time155156 - `display_name: string`157158 Human-readable, single-line label for the Skill. Maximum 255 characters.159 Always set: derived from the SKILL.md frontmatter `name` when omitted at160 creation. Not unique.161162 - `latest_version_id: string`163164 ID of the newest Skill Version — what `latest` references resolve to. Always set: a Skill holds at least one version.165166 - `source: BetaSkillSource`167168 Where the Skill comes from.169170 Possible values:171172 * `"custom"`: authored by the platform user; private to their workspace173 * `"anthropic"`: published by Anthropic; shared and read-only174 * `"anthropic_example"`: Anthropic-published sample Skill175 * `"plugin"`: resolved from an installed plugin176177 - `type: "custom" or "anthropic" or "anthropic_example" or "plugin"`178179 Where the Skill comes from.180181 Possible values:182183 * `"custom"`: authored by the platform user; private to their workspace184 * `"anthropic"`: published by Anthropic; shared and read-only185 * `"anthropic_example"`: Anthropic-published sample Skill186 * `"plugin"`: resolved from an installed plugin187188 - `"custom"`189190 - `"anthropic"`191192 - `"anthropic_example"`193194 - `"plugin"`195196 - `updated_at: string`197198 ISO 8601 timestamp of when the skill was last updated.199200 format: date-time201202### Example203204```bash205curl https://api.anthropic.com/v1/skills \206 -H 'Content-Type: multipart/form-data' \207 -H 'anthropic-version: 2023-06-01' \208 -H "X-Api-Key: $ANTHROPIC_API_KEY" \209 -F 'files[]=@/path/to/file'210```211212#### Response (200)213214```json215{216 "id": "skill_01JAbcdefghijklmnopqrstuvw",217 "created_at": "2024-10-30T23:58:27.427722Z",218 "display_name": "display_name",219 "latest_version_id": "latest_version_id",220 "source": {221 "type": "custom"222 },223 "type": "skill",224 "updated_at": "2024-10-30T23:58:27.427722Z"225}226```227228## List Skills229230**GET** `/v1/skills`231232List Skills233234### Query parameters235236- `limit: optional number`237238 Number of results to return per page.239240 Ranges from `1` to `1000`. Defaults to `20`.241242 default: 20, minimum: 1, maximum: 1000243244- `page: optional string`245246 Pagination token for fetching a specific page of results.247248 Pass the value from a previous response's `next_page` field to get the next page of results.249250- `source: optional string`251252 Filter skills by source.253254 If provided, only skills from the specified source will be returned:255256 * `"custom"`: only return user-created skills257 * `"anthropic"`: only return Anthropic-created skills258259### Headers260261- `"anthropic-beta": optional array of AnthropicBeta`262263 Optional header to specify the beta version(s) you want to use.264265 - `string`266267 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 43 more`268269 - `"message-batches-2024-09-24"`270271 - `"prompt-caching-2024-07-31"`272273 - `"computer-use-2024-10-22"`274275 - `"computer-use-2025-01-24"`276277 - `"pdfs-2024-09-25"`278279 - `"token-counting-2024-11-01"`280281 - `"token-efficient-tools-2025-02-19"`282283 - `"output-128k-2025-02-19"`284285 - `"files-api-2025-04-14"`286287 - `"mcp-client-2025-04-04"`288289 - `"mcp-client-2025-11-20"`290291 - `"dev-full-thinking-2025-05-14"`292293 - `"interleaved-thinking-2025-05-14"`294295 - `"code-execution-2025-05-22"`296297 - `"extended-cache-ttl-2025-04-11"`298299 - `"context-1m-2025-08-07"`300301 - `"context-management-2025-06-27"`302303 - `"model-context-window-exceeded-2025-08-26"`304305 - `"skills-2025-10-02"`306307 - `"fast-mode-2026-02-01"`308309 - `"output-300k-2026-03-24"`310311 - `"user-profiles-2026-03-24"`312313 - `"user-profiles-2026-08-18"`314315 - `"user-profiles-2026-09-04"`316317 - `"advisor-tool-2026-03-01"`318319 - `"managed-agents-2026-04-01"`320321 - `"cache-diagnosis-2026-04-07"`322323 - `"dreaming-2026-04-21"`324325 - `"thinking-token-count-2026-05-13"`326327 - `"server-side-fallback-2026-06-01"`328329 - `"server-side-fallback-2026-07-01"`330331 - `"fallback-credit-2026-06-01"`332333 - `"fallback-credit-2026-07-01"`334335 - `"agent-memory-2026-07-22"`336337 - `"mid-conversation-tool-changes-2026-07-01"`338339 - `"compact-2026-01-12"`340341 - `"computer-use-2025-11-24"`342343 - `"mcp-tunnels-2026-06-22"`344345 - `"structured-outputs-2025-11-13"`346347 - `"task-budgets-2026-03-13"`348349 - `"thinking-display-updates-2026-08-18"`350351 - `"ce-user-management-2026-07-13"`352353 - `"mid-conversation-output-config-2026-07-01"`354355 - `"thinking-binding-controls-2026-08-01"`356357 - `"mid-conversation-system-clear-at-2026-08-21"`358359 - `"compact-2026-09-04"`360361- `"anthropic-workspace-id": optional string`362363### Returns364365- `data: array of BetaSkill`366367 List of skills.368369 - `type: "skill"`370371 Object type.372373 For Skills, this is always `"skill"`.374375 default: skill376377 - `id: string`378379 Unique identifier for the skill.380381 The format and length of IDs may change over time.382383 - `created_at: string`384385 ISO 8601 timestamp of when the skill was created.386387 format: date-time388389 - `display_name: string`390391 Human-readable, single-line label for the Skill. Maximum 255 characters.392 Always set: derived from the SKILL.md frontmatter `name` when omitted at393 creation. Not unique.394395 - `latest_version_id: string`396397 ID of the newest Skill Version — what `latest` references resolve to. Always set: a Skill holds at least one version.398399 - `source: BetaSkillSource`400401 Where the Skill comes from.402403 Possible values:404405 * `"custom"`: authored by the platform user; private to their workspace406 * `"anthropic"`: published by Anthropic; shared and read-only407 * `"anthropic_example"`: Anthropic-published sample Skill408 * `"plugin"`: resolved from an installed plugin409410 - `type: "custom" or "anthropic" or "anthropic_example" or "plugin"`411412 Where the Skill comes from.413414 Possible values:415416 * `"custom"`: authored by the platform user; private to their workspace417 * `"anthropic"`: published by Anthropic; shared and read-only418 * `"anthropic_example"`: Anthropic-published sample Skill419 * `"plugin"`: resolved from an installed plugin420421 - `"custom"`422423 - `"anthropic"`424425 - `"anthropic_example"`426427 - `"plugin"`428429 - `updated_at: string`430431 ISO 8601 timestamp of when the skill was last updated.432433 format: date-time434435- `next_page: string or null`436437 Token for fetching the next page of results.438439 If `null`, there are no more results available. Pass this value to the `page` parameter in the next request to get the next page.440441### Example442443```bash444curl https://api.anthropic.com/v1/skills \445 -H 'anthropic-version: 2023-06-01' \446 -H "X-Api-Key: $ANTHROPIC_API_KEY"447```448449#### Response (200)450451```json452{453 "data": [454 {455 "id": "skill_01JAbcdefghijklmnopqrstuvw",456 "created_at": "2024-10-30T23:58:27.427722Z",457 "display_name": "display_name",458 "latest_version_id": "latest_version_id",459 "source": {460 "type": "custom"461 },462 "type": "skill",463 "updated_at": "2024-10-30T23:58:27.427722Z"464 }465 ],466 "next_page": "next_page"467}468```469470## Get Skill471472**GET** `/v1/skills/{skill_id}`473474Get Skill475476### Path parameters477478- `skill_id: string`479480 Unique identifier for the skill.481482 The format and length of IDs may change over time.483484### Headers485486- `"anthropic-beta": optional array of AnthropicBeta`487488 Optional header to specify the beta version(s) you want to use.489490 - `string`491492 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 43 more`493494 - `"message-batches-2024-09-24"`495496 - `"prompt-caching-2024-07-31"`497498 - `"computer-use-2024-10-22"`499500 - `"computer-use-2025-01-24"`501502 - `"pdfs-2024-09-25"`503504 - `"token-counting-2024-11-01"`505506 - `"token-efficient-tools-2025-02-19"`507508 - `"output-128k-2025-02-19"`509510 - `"files-api-2025-04-14"`511512 - `"mcp-client-2025-04-04"`513514 - `"mcp-client-2025-11-20"`515516 - `"dev-full-thinking-2025-05-14"`517518 - `"interleaved-thinking-2025-05-14"`519520 - `"code-execution-2025-05-22"`521522 - `"extended-cache-ttl-2025-04-11"`523524 - `"context-1m-2025-08-07"`525526 - `"context-management-2025-06-27"`527528 - `"model-context-window-exceeded-2025-08-26"`529530 - `"skills-2025-10-02"`531532 - `"fast-mode-2026-02-01"`533534 - `"output-300k-2026-03-24"`535536 - `"user-profiles-2026-03-24"`537538 - `"user-profiles-2026-08-18"`539540 - `"user-profiles-2026-09-04"`541542 - `"advisor-tool-2026-03-01"`543544 - `"managed-agents-2026-04-01"`545546 - `"cache-diagnosis-2026-04-07"`547548 - `"dreaming-2026-04-21"`549550 - `"thinking-token-count-2026-05-13"`551552 - `"server-side-fallback-2026-06-01"`553554 - `"server-side-fallback-2026-07-01"`555556 - `"fallback-credit-2026-06-01"`557558 - `"fallback-credit-2026-07-01"`559560 - `"agent-memory-2026-07-22"`561562 - `"mid-conversation-tool-changes-2026-07-01"`563564 - `"compact-2026-01-12"`565566 - `"computer-use-2025-11-24"`567568 - `"mcp-tunnels-2026-06-22"`569570 - `"structured-outputs-2025-11-13"`571572 - `"task-budgets-2026-03-13"`573574 - `"thinking-display-updates-2026-08-18"`575576 - `"ce-user-management-2026-07-13"`577578 - `"mid-conversation-output-config-2026-07-01"`579580 - `"thinking-binding-controls-2026-08-01"`581582 - `"mid-conversation-system-clear-at-2026-08-21"`583584 - `"compact-2026-09-04"`585586- `"anthropic-workspace-id": optional string`587588### Returns589590- `BetaSkill object`591592 - `type: "skill"`593594 Object type.595596 For Skills, this is always `"skill"`.597598 default: skill599600 - `id: string`601602 Unique identifier for the skill.603604 The format and length of IDs may change over time.605606 - `created_at: string`607608 ISO 8601 timestamp of when the skill was created.609610 format: date-time611612 - `display_name: string`613614 Human-readable, single-line label for the Skill. Maximum 255 characters.615 Always set: derived from the SKILL.md frontmatter `name` when omitted at616 creation. Not unique.617618 - `latest_version_id: string`619620 ID of the newest Skill Version — what `latest` references resolve to. Always set: a Skill holds at least one version.621622 - `source: BetaSkillSource`623624 Where the Skill comes from.625626 Possible values:627628 * `"custom"`: authored by the platform user; private to their workspace629 * `"anthropic"`: published by Anthropic; shared and read-only630 * `"anthropic_example"`: Anthropic-published sample Skill631 * `"plugin"`: resolved from an installed plugin632633 - `type: "custom" or "anthropic" or "anthropic_example" or "plugin"`634635 Where the Skill comes from.636637 Possible values:638639 * `"custom"`: authored by the platform user; private to their workspace640 * `"anthropic"`: published by Anthropic; shared and read-only641 * `"anthropic_example"`: Anthropic-published sample Skill642 * `"plugin"`: resolved from an installed plugin643644 - `"custom"`645646 - `"anthropic"`647648 - `"anthropic_example"`649650 - `"plugin"`651652 - `updated_at: string`653654 ISO 8601 timestamp of when the skill was last updated.655656 format: date-time657658### Example659660```bash661curl https://api.anthropic.com/v1/skills/$SKILL_ID \662 -H 'anthropic-version: 2023-06-01' \663 -H "X-Api-Key: $ANTHROPIC_API_KEY"664```665666#### Response (200)667668```json669{670 "id": "skill_01JAbcdefghijklmnopqrstuvw",671 "created_at": "2024-10-30T23:58:27.427722Z",672 "display_name": "display_name",673 "latest_version_id": "latest_version_id",674 "source": {675 "type": "custom"676 },677 "type": "skill",678 "updated_at": "2024-10-30T23:58:27.427722Z"679}680```681682## Delete Skill683684**DELETE** `/v1/skills/{skill_id}`685686Delete Skill687688### Path parameters689690- `skill_id: string`691692 Unique identifier for the skill.693694 The format and length of IDs may change over time.695696### Headers697698- `"anthropic-beta": optional array of AnthropicBeta`699700 Optional header to specify the beta version(s) you want to use.701702 - `string`703704 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 43 more`705706 - `"message-batches-2024-09-24"`707708 - `"prompt-caching-2024-07-31"`709710 - `"computer-use-2024-10-22"`711712 - `"computer-use-2025-01-24"`713714 - `"pdfs-2024-09-25"`715716 - `"token-counting-2024-11-01"`717718 - `"token-efficient-tools-2025-02-19"`719720 - `"output-128k-2025-02-19"`721722 - `"files-api-2025-04-14"`723724 - `"mcp-client-2025-04-04"`725726 - `"mcp-client-2025-11-20"`727728 - `"dev-full-thinking-2025-05-14"`729730 - `"interleaved-thinking-2025-05-14"`731732 - `"code-execution-2025-05-22"`733734 - `"extended-cache-ttl-2025-04-11"`735736 - `"context-1m-2025-08-07"`737738 - `"context-management-2025-06-27"`739740 - `"model-context-window-exceeded-2025-08-26"`741742 - `"skills-2025-10-02"`743744 - `"fast-mode-2026-02-01"`745746 - `"output-300k-2026-03-24"`747748 - `"user-profiles-2026-03-24"`749750 - `"user-profiles-2026-08-18"`751752 - `"user-profiles-2026-09-04"`753754 - `"advisor-tool-2026-03-01"`755756 - `"managed-agents-2026-04-01"`757758 - `"cache-diagnosis-2026-04-07"`759760 - `"dreaming-2026-04-21"`761762 - `"thinking-token-count-2026-05-13"`763764 - `"server-side-fallback-2026-06-01"`765766 - `"server-side-fallback-2026-07-01"`767768 - `"fallback-credit-2026-06-01"`769770 - `"fallback-credit-2026-07-01"`771772 - `"agent-memory-2026-07-22"`773774 - `"mid-conversation-tool-changes-2026-07-01"`775776 - `"compact-2026-01-12"`777778 - `"computer-use-2025-11-24"`779780 - `"mcp-tunnels-2026-06-22"`781782 - `"structured-outputs-2025-11-13"`783784 - `"task-budgets-2026-03-13"`785786 - `"thinking-display-updates-2026-08-18"`787788 - `"ce-user-management-2026-07-13"`789790 - `"mid-conversation-output-config-2026-07-01"`791792 - `"thinking-binding-controls-2026-08-01"`793794 - `"mid-conversation-system-clear-at-2026-08-21"`795796 - `"compact-2026-09-04"`797798- `"anthropic-workspace-id": optional string`799800### Returns801802- `BetaDeletedSkill object`803804 - `type: "skill_deleted"`805806 Deleted object type.807808 For Skills, this is always `"skill_deleted"`.809810 default: skill_deleted811812 - `id: string`813814 Unique identifier for the skill.815816 The format and length of IDs may change over time.817818### Example819820```bash821curl https://api.anthropic.com/v1/skills/$SKILL_ID \822 -X DELETE \823 -H 'anthropic-version: 2023-06-01' \824 -H "X-Api-Key: $ANTHROPIC_API_KEY"825```826827#### Response (200)828829```json830{831 "id": "skill_01JAbcdefghijklmnopqrstuvw",832 "type": "skill_deleted"833}834```835836## Domain types837838### Beta Deleted Skill839840- `BetaDeletedSkill object`841842 - `type: "skill_deleted"`843844 Deleted object type.845846 For Skills, this is always `"skill_deleted"`.847848 default: skill_deleted849850 - `id: string`851852 Unique identifier for the skill.853854 The format and length of IDs may change over time.855856### Beta Skill857858- `BetaSkill object`859860 - `type: "skill"`861862 Object type.863864 For Skills, this is always `"skill"`.865866 default: skill867868 - `id: string`869870 Unique identifier for the skill.871872 The format and length of IDs may change over time.873874 - `created_at: string`875876 ISO 8601 timestamp of when the skill was created.877878 format: date-time879880 - `display_name: string`881882 Human-readable, single-line label for the Skill. Maximum 255 characters.883 Always set: derived from the SKILL.md frontmatter `name` when omitted at884 creation. Not unique.885886 - `latest_version_id: string`887888 ID of the newest Skill Version — what `latest` references resolve to. Always set: a Skill holds at least one version.889890 - `source: BetaSkillSource`891892 Where the Skill comes from.893894 Possible values:895896 * `"custom"`: authored by the platform user; private to their workspace897 * `"anthropic"`: published by Anthropic; shared and read-only898 * `"anthropic_example"`: Anthropic-published sample Skill899 * `"plugin"`: resolved from an installed plugin900901 - `type: "custom" or "anthropic" or "anthropic_example" or "plugin"`902903 Where the Skill comes from.904905 Possible values:906907 * `"custom"`: authored by the platform user; private to their workspace908 * `"anthropic"`: published by Anthropic; shared and read-only909 * `"anthropic_example"`: Anthropic-published sample Skill910 * `"plugin"`: resolved from an installed plugin911912 - `"custom"`913914 - `"anthropic"`915916 - `"anthropic_example"`917918 - `"plugin"`919920 - `updated_at: string`921922 ISO 8601 timestamp of when the skill was last updated.923924 format: date-time925926### Beta Skill Source927928- `BetaSkillSource object`929930 - `type: "custom" or "anthropic" or "anthropic_example" or "plugin"`931932 Where the Skill comes from.933934 Possible values:935936 * `"custom"`: authored by the platform user; private to their workspace937 * `"anthropic"`: published by Anthropic; shared and read-only938 * `"anthropic_example"`: Anthropic-published sample Skill939 * `"plugin"`: resolved from an installed plugin940941 - `"custom"`942943 - `"anthropic"`944945 - `"anthropic_example"`946947 - `"plugin"`948949## Skills › Versions950951### Create Skill Version952953**POST** `/v1/skills/{skill_id}/versions`954955Create Skill Version956957#### Path parameters958959- `skill_id: string`960961 Unique identifier for the skill.962963 The format and length of IDs may change over time.964965#### Headers966967- `"anthropic-beta": optional array of AnthropicBeta`968969 Optional header to specify the beta version(s) you want to use.970971 - `string`972973 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 43 more`974975 - `"message-batches-2024-09-24"`976977 - `"prompt-caching-2024-07-31"`978979 - `"computer-use-2024-10-22"`980981 - `"computer-use-2025-01-24"`982983 - `"pdfs-2024-09-25"`984985 - `"token-counting-2024-11-01"`986987 - `"token-efficient-tools-2025-02-19"`988989 - `"output-128k-2025-02-19"`990991 - `"files-api-2025-04-14"`992993 - `"mcp-client-2025-04-04"`994995 - `"mcp-client-2025-11-20"`996997 - `"dev-full-thinking-2025-05-14"`998999 - `"interleaved-thinking-2025-05-14"`10001001 - `"code-execution-2025-05-22"`10021003 - `"extended-cache-ttl-2025-04-11"`10041005 - `"context-1m-2025-08-07"`10061007 - `"context-management-2025-06-27"`10081009 - `"model-context-window-exceeded-2025-08-26"`10101011 - `"skills-2025-10-02"`10121013 - `"fast-mode-2026-02-01"`10141015 - `"output-300k-2026-03-24"`10161017 - `"user-profiles-2026-03-24"`10181019 - `"user-profiles-2026-08-18"`10201021 - `"user-profiles-2026-09-04"`10221023 - `"advisor-tool-2026-03-01"`10241025 - `"managed-agents-2026-04-01"`10261027 - `"cache-diagnosis-2026-04-07"`10281029 - `"dreaming-2026-04-21"`10301031 - `"thinking-token-count-2026-05-13"`10321033 - `"server-side-fallback-2026-06-01"`10341035 - `"server-side-fallback-2026-07-01"`10361037 - `"fallback-credit-2026-06-01"`10381039 - `"fallback-credit-2026-07-01"`10401041 - `"agent-memory-2026-07-22"`10421043 - `"mid-conversation-tool-changes-2026-07-01"`10441045 - `"compact-2026-01-12"`10461047 - `"computer-use-2025-11-24"`10481049 - `"mcp-tunnels-2026-06-22"`10501051 - `"structured-outputs-2025-11-13"`10521053 - `"task-budgets-2026-03-13"`10541055 - `"thinking-display-updates-2026-08-18"`10561057 - `"ce-user-management-2026-07-13"`10581059 - `"mid-conversation-output-config-2026-07-01"`10601061 - `"thinking-binding-controls-2026-08-01"`10621063 - `"mid-conversation-system-clear-at-2026-08-21"`10641065 - `"compact-2026-09-04"`10661067- `"anthropic-workspace-id": optional string`10681069#### Body parameters (form-data)10701071- `files: array of string`10721073 Files to upload for the skill.10741075 All files must be in the same top-level directory and must include a SKILL.md file at the root of that directory.10761077#### Returns10781079- `BetaSkillVersion object`10801081 - `type: "skill_version"`10821083 Object type.10841085 For Skill Versions, this is always `"skill_version"`.10861087 default: skill_version10881089 - `id: string`10901091 Unique identifier for this Skill Version. The id addresses the version in1092 paths and pins it in references.10931094 - `created_at: string`10951096 ISO 8601 timestamp of when the skill was created.10971098 format: date-time10991100 - `description: string`11011102 Description of the skill version.11031104 This is extracted from the SKILL.md file in the skill upload.11051106 - `name: string`11071108 The Skill's immutable kebab-case slug, set at creation from the first1109 upload's SKILL.md frontmatter `name` (or its enclosing directory). Every1110 later upload must resolve to the same value. Also the top-level directory1111 of the Skill's mounted files and the base name of a downloaded archive.11121113 - `skill_id: string`11141115 Unique identifier for the skill.11161117 The format and length of IDs may change over time.11181119#### Example11201121```bash1122curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions \1123 -H 'Content-Type: multipart/form-data' \1124 -H 'anthropic-version: 2023-06-01' \1125 -H "X-Api-Key: $ANTHROPIC_API_KEY" \1126 -F 'files[]=@/path/to/file'1127```11281129##### Response (200)11301131```json1132{1133 "id": "id",1134 "created_at": "2024-10-30T23:58:27.427722Z",1135 "description": "description",1136 "name": "name",1137 "skill_id": "skill_01JAbcdefghijklmnopqrstuvw",1138 "type": "skill_version"1139}1140```11411142### List Skill Versions11431144**GET** `/v1/skills/{skill_id}/versions`11451146List Skill Versions11471148#### Path parameters11491150- `skill_id: string`11511152 Unique identifier for the skill.11531154 The format and length of IDs may change over time.11551156#### Query parameters11571158- `limit: optional number`11591160 Number of results to return per page.11611162 Ranges from `1` to `1000`. Defaults to `20`.11631164 default: 20, minimum: 1, maximum: 100011651166- `page: optional string`11671168 Optionally set to the `next_page` token from the previous response.11691170#### Headers11711172- `"anthropic-beta": optional array of AnthropicBeta`11731174 Optional header to specify the beta version(s) you want to use.11751176 - `string`11771178 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 43 more`11791180 - `"message-batches-2024-09-24"`11811182 - `"prompt-caching-2024-07-31"`11831184 - `"computer-use-2024-10-22"`11851186 - `"computer-use-2025-01-24"`11871188 - `"pdfs-2024-09-25"`11891190 - `"token-counting-2024-11-01"`11911192 - `"token-efficient-tools-2025-02-19"`11931194 - `"output-128k-2025-02-19"`11951196 - `"files-api-2025-04-14"`11971198 - `"mcp-client-2025-04-04"`11991200 - `"mcp-client-2025-11-20"`12011202 - `"dev-full-thinking-2025-05-14"`12031204 - `"interleaved-thinking-2025-05-14"`12051206 - `"code-execution-2025-05-22"`12071208 - `"extended-cache-ttl-2025-04-11"`12091210 - `"context-1m-2025-08-07"`12111212 - `"context-management-2025-06-27"`12131214 - `"model-context-window-exceeded-2025-08-26"`12151216 - `"skills-2025-10-02"`12171218 - `"fast-mode-2026-02-01"`12191220 - `"output-300k-2026-03-24"`12211222 - `"user-profiles-2026-03-24"`12231224 - `"user-profiles-2026-08-18"`12251226 - `"user-profiles-2026-09-04"`12271228 - `"advisor-tool-2026-03-01"`12291230 - `"managed-agents-2026-04-01"`12311232 - `"cache-diagnosis-2026-04-07"`12331234 - `"dreaming-2026-04-21"`12351236 - `"thinking-token-count-2026-05-13"`12371238 - `"server-side-fallback-2026-06-01"`12391240 - `"server-side-fallback-2026-07-01"`12411242 - `"fallback-credit-2026-06-01"`12431244 - `"fallback-credit-2026-07-01"`12451246 - `"agent-memory-2026-07-22"`12471248 - `"mid-conversation-tool-changes-2026-07-01"`12491250 - `"compact-2026-01-12"`12511252 - `"computer-use-2025-11-24"`12531254 - `"mcp-tunnels-2026-06-22"`12551256 - `"structured-outputs-2025-11-13"`12571258 - `"task-budgets-2026-03-13"`12591260 - `"thinking-display-updates-2026-08-18"`12611262 - `"ce-user-management-2026-07-13"`12631264 - `"mid-conversation-output-config-2026-07-01"`12651266 - `"thinking-binding-controls-2026-08-01"`12671268 - `"mid-conversation-system-clear-at-2026-08-21"`12691270 - `"compact-2026-09-04"`12711272- `"anthropic-workspace-id": optional string`12731274#### Returns12751276- `data: array of BetaSkillVersion`12771278 List of skills.12791280 - `type: "skill_version"`12811282 Object type.12831284 For Skill Versions, this is always `"skill_version"`.12851286 default: skill_version12871288 - `id: string`12891290 Unique identifier for this Skill Version. The id addresses the version in1291 paths and pins it in references.12921293 - `created_at: string`12941295 ISO 8601 timestamp of when the skill was created.12961297 format: date-time12981299 - `description: string`13001301 Description of the skill version.13021303 This is extracted from the SKILL.md file in the skill upload.13041305 - `name: string`13061307 The Skill's immutable kebab-case slug, set at creation from the first1308 upload's SKILL.md frontmatter `name` (or its enclosing directory). Every1309 later upload must resolve to the same value. Also the top-level directory1310 of the Skill's mounted files and the base name of a downloaded archive.13111312 - `skill_id: string`13131314 Unique identifier for the skill.13151316 The format and length of IDs may change over time.13171318- `next_page: string or null`13191320 Token for fetching the next page of results.13211322 If `null`, there are no more results available. Pass this value to the `page` parameter in the next request to get the next page.13231324#### Example13251326```bash1327curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions \1328 -H 'anthropic-version: 2023-06-01' \1329 -H "X-Api-Key: $ANTHROPIC_API_KEY"1330```13311332##### Response (200)13331334```json1335{1336 "data": [1337 {1338 "id": "id",1339 "created_at": "2024-10-30T23:58:27.427722Z",1340 "description": "description",1341 "name": "name",1342 "skill_id": "skill_01JAbcdefghijklmnopqrstuvw",1343 "type": "skill_version"1344 }1345 ],1346 "next_page": "next_page"1347}1348```13491350### Download Skill Version Content13511352**GET** `/v1/skills/{skill_id}/versions/{version}/content`13531354Download a skill version's content as a zip archive.13551356#### Path parameters13571358- `skill_id: string`13591360 Unique identifier for the skill.13611362 The format and length of IDs may change over time.13631364- `version: string`13651366 Identifies the skill version by its version ID.13671368 Requests carrying the `skills-2025-10-02` beta header address versions by their Unix epoch timestamp instead (e.g., "1759178010641129").13691370#### Headers13711372- `"anthropic-beta": optional array of AnthropicBeta`13731374 Optional header to specify the beta version(s) you want to use.13751376 - `string`13771378 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 43 more`13791380 - `"message-batches-2024-09-24"`13811382 - `"prompt-caching-2024-07-31"`13831384 - `"computer-use-2024-10-22"`13851386 - `"computer-use-2025-01-24"`13871388 - `"pdfs-2024-09-25"`13891390 - `"token-counting-2024-11-01"`13911392 - `"token-efficient-tools-2025-02-19"`13931394 - `"output-128k-2025-02-19"`13951396 - `"files-api-2025-04-14"`13971398 - `"mcp-client-2025-04-04"`13991400 - `"mcp-client-2025-11-20"`14011402 - `"dev-full-thinking-2025-05-14"`14031404 - `"interleaved-thinking-2025-05-14"`14051406 - `"code-execution-2025-05-22"`14071408 - `"extended-cache-ttl-2025-04-11"`14091410 - `"context-1m-2025-08-07"`14111412 - `"context-management-2025-06-27"`14131414 - `"model-context-window-exceeded-2025-08-26"`14151416 - `"skills-2025-10-02"`14171418 - `"fast-mode-2026-02-01"`14191420 - `"output-300k-2026-03-24"`14211422 - `"user-profiles-2026-03-24"`14231424 - `"user-profiles-2026-08-18"`14251426 - `"user-profiles-2026-09-04"`14271428 - `"advisor-tool-2026-03-01"`14291430 - `"managed-agents-2026-04-01"`14311432 - `"cache-diagnosis-2026-04-07"`14331434 - `"dreaming-2026-04-21"`14351436 - `"thinking-token-count-2026-05-13"`14371438 - `"server-side-fallback-2026-06-01"`14391440 - `"server-side-fallback-2026-07-01"`14411442 - `"fallback-credit-2026-06-01"`14431444 - `"fallback-credit-2026-07-01"`14451446 - `"agent-memory-2026-07-22"`14471448 - `"mid-conversation-tool-changes-2026-07-01"`14491450 - `"compact-2026-01-12"`14511452 - `"computer-use-2025-11-24"`14531454 - `"mcp-tunnels-2026-06-22"`14551456 - `"structured-outputs-2025-11-13"`14571458 - `"task-budgets-2026-03-13"`14591460 - `"thinking-display-updates-2026-08-18"`14611462 - `"ce-user-management-2026-07-13"`14631464 - `"mid-conversation-output-config-2026-07-01"`14651466 - `"thinking-binding-controls-2026-08-01"`14671468 - `"mid-conversation-system-clear-at-2026-08-21"`14691470 - `"compact-2026-09-04"`14711472- `"anthropic-workspace-id": optional string`14731474#### Example14751476```bash1477curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions/$VERSION/content \1478 -H 'anthropic-version: 2023-06-01' \1479 -H "X-Api-Key: $ANTHROPIC_API_KEY"1480```14811482### Get Skill Version14831484**GET** `/v1/skills/{skill_id}/versions/{version}`14851486Get Skill Version14871488#### Path parameters14891490- `skill_id: string`14911492 Unique identifier for the skill.14931494 The format and length of IDs may change over time.14951496- `version: string`14971498 Identifies the skill version: a version ID, or the literal `latest` for the skill's most recent version.14991500 Requests carrying the `skills-2025-10-02` beta header address versions by their Unix epoch timestamp instead (e.g., "1759178010641129").15011502#### Headers15031504- `"anthropic-beta": optional array of AnthropicBeta`15051506 Optional header to specify the beta version(s) you want to use.15071508 - `string`15091510 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 43 more`15111512 - `"message-batches-2024-09-24"`15131514 - `"prompt-caching-2024-07-31"`15151516 - `"computer-use-2024-10-22"`15171518 - `"computer-use-2025-01-24"`15191520 - `"pdfs-2024-09-25"`15211522 - `"token-counting-2024-11-01"`15231524 - `"token-efficient-tools-2025-02-19"`15251526 - `"output-128k-2025-02-19"`15271528 - `"files-api-2025-04-14"`15291530 - `"mcp-client-2025-04-04"`15311532 - `"mcp-client-2025-11-20"`15331534 - `"dev-full-thinking-2025-05-14"`15351536 - `"interleaved-thinking-2025-05-14"`15371538 - `"code-execution-2025-05-22"`15391540 - `"extended-cache-ttl-2025-04-11"`15411542 - `"context-1m-2025-08-07"`15431544 - `"context-management-2025-06-27"`15451546 - `"model-context-window-exceeded-2025-08-26"`15471548 - `"skills-2025-10-02"`15491550 - `"fast-mode-2026-02-01"`15511552 - `"output-300k-2026-03-24"`15531554 - `"user-profiles-2026-03-24"`15551556 - `"user-profiles-2026-08-18"`15571558 - `"user-profiles-2026-09-04"`15591560 - `"advisor-tool-2026-03-01"`15611562 - `"managed-agents-2026-04-01"`15631564 - `"cache-diagnosis-2026-04-07"`15651566 - `"dreaming-2026-04-21"`15671568 - `"thinking-token-count-2026-05-13"`15691570 - `"server-side-fallback-2026-06-01"`15711572 - `"server-side-fallback-2026-07-01"`15731574 - `"fallback-credit-2026-06-01"`15751576 - `"fallback-credit-2026-07-01"`15771578 - `"agent-memory-2026-07-22"`15791580 - `"mid-conversation-tool-changes-2026-07-01"`15811582 - `"compact-2026-01-12"`15831584 - `"computer-use-2025-11-24"`15851586 - `"mcp-tunnels-2026-06-22"`15871588 - `"structured-outputs-2025-11-13"`15891590 - `"task-budgets-2026-03-13"`15911592 - `"thinking-display-updates-2026-08-18"`15931594 - `"ce-user-management-2026-07-13"`15951596 - `"mid-conversation-output-config-2026-07-01"`15971598 - `"thinking-binding-controls-2026-08-01"`15991600 - `"mid-conversation-system-clear-at-2026-08-21"`16011602 - `"compact-2026-09-04"`16031604- `"anthropic-workspace-id": optional string`16051606#### Returns16071608- `BetaSkillVersion object`16091610 - `type: "skill_version"`16111612 Object type.16131614 For Skill Versions, this is always `"skill_version"`.16151616 default: skill_version16171618 - `id: string`16191620 Unique identifier for this Skill Version. The id addresses the version in1621 paths and pins it in references.16221623 - `created_at: string`16241625 ISO 8601 timestamp of when the skill was created.16261627 format: date-time16281629 - `description: string`16301631 Description of the skill version.16321633 This is extracted from the SKILL.md file in the skill upload.16341635 - `name: string`16361637 The Skill's immutable kebab-case slug, set at creation from the first1638 upload's SKILL.md frontmatter `name` (or its enclosing directory). Every1639 later upload must resolve to the same value. Also the top-level directory1640 of the Skill's mounted files and the base name of a downloaded archive.16411642 - `skill_id: string`16431644 Unique identifier for the skill.16451646 The format and length of IDs may change over time.16471648#### Example16491650```bash1651curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions/$VERSION \1652 -H 'anthropic-version: 2023-06-01' \1653 -H "X-Api-Key: $ANTHROPIC_API_KEY"1654```16551656##### Response (200)16571658```json1659{1660 "id": "id",1661 "created_at": "2024-10-30T23:58:27.427722Z",1662 "description": "description",1663 "name": "name",1664 "skill_id": "skill_01JAbcdefghijklmnopqrstuvw",1665 "type": "skill_version"1666}1667```16681669### Delete Skill Version16701671**DELETE** `/v1/skills/{skill_id}/versions/{version}`16721673Delete Skill Version16741675#### Path parameters16761677- `skill_id: string`16781679 Unique identifier for the skill.16801681 The format and length of IDs may change over time.16821683- `version: string`16841685 Identifies the skill version by its version ID.16861687 Requests carrying the `skills-2025-10-02` beta header address versions by their Unix epoch timestamp instead (e.g., "1759178010641129").16881689#### Headers16901691- `"anthropic-beta": optional array of AnthropicBeta`16921693 Optional header to specify the beta version(s) you want to use.16941695 - `string`16961697 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 43 more`16981699 - `"message-batches-2024-09-24"`17001701 - `"prompt-caching-2024-07-31"`17021703 - `"computer-use-2024-10-22"`17041705 - `"computer-use-2025-01-24"`17061707 - `"pdfs-2024-09-25"`17081709 - `"token-counting-2024-11-01"`17101711 - `"token-efficient-tools-2025-02-19"`17121713 - `"output-128k-2025-02-19"`17141715 - `"files-api-2025-04-14"`17161717 - `"mcp-client-2025-04-04"`17181719 - `"mcp-client-2025-11-20"`17201721 - `"dev-full-thinking-2025-05-14"`17221723 - `"interleaved-thinking-2025-05-14"`17241725 - `"code-execution-2025-05-22"`17261727 - `"extended-cache-ttl-2025-04-11"`17281729 - `"context-1m-2025-08-07"`17301731 - `"context-management-2025-06-27"`17321733 - `"model-context-window-exceeded-2025-08-26"`17341735 - `"skills-2025-10-02"`17361737 - `"fast-mode-2026-02-01"`17381739 - `"output-300k-2026-03-24"`17401741 - `"user-profiles-2026-03-24"`17421743 - `"user-profiles-2026-08-18"`17441745 - `"user-profiles-2026-09-04"`17461747 - `"advisor-tool-2026-03-01"`17481749 - `"managed-agents-2026-04-01"`17501751 - `"cache-diagnosis-2026-04-07"`17521753 - `"dreaming-2026-04-21"`17541755 - `"thinking-token-count-2026-05-13"`17561757 - `"server-side-fallback-2026-06-01"`17581759 - `"server-side-fallback-2026-07-01"`17601761 - `"fallback-credit-2026-06-01"`17621763 - `"fallback-credit-2026-07-01"`17641765 - `"agent-memory-2026-07-22"`17661767 - `"mid-conversation-tool-changes-2026-07-01"`17681769 - `"compact-2026-01-12"`17701771 - `"computer-use-2025-11-24"`17721773 - `"mcp-tunnels-2026-06-22"`17741775 - `"structured-outputs-2025-11-13"`17761777 - `"task-budgets-2026-03-13"`17781779 - `"thinking-display-updates-2026-08-18"`17801781 - `"ce-user-management-2026-07-13"`17821783 - `"mid-conversation-output-config-2026-07-01"`17841785 - `"thinking-binding-controls-2026-08-01"`17861787 - `"mid-conversation-system-clear-at-2026-08-21"`17881789 - `"compact-2026-09-04"`17901791- `"anthropic-workspace-id": optional string`17921793#### Returns17941795- `BetaDeletedSkillVersion object`17961797 - `type: "skill_version_deleted"`17981799 Deleted object type.18001801 For Skill Versions, this is always `"skill_version_deleted"`.18021803 default: skill_version_deleted18041805 - `id: string`18061807 Unique identifier for this Skill Version. The id addresses the version in1808 paths and pins it in references.18091810#### Example18111812```bash1813curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions/$VERSION \1814 -X DELETE \1815 -H 'anthropic-version: 2023-06-01' \1816 -H "X-Api-Key: $ANTHROPIC_API_KEY"1817```18181819##### Response (200)18201821```json1822{1823 "id": "id",1824 "type": "skill_version_deleted"1825}1826```1827