# Skills ## Create Skill **post** `/v1/skills` Create Skill ### Header Parameters - `"anthropic-beta": optional array of AnthropicBeta` Optional header to specify the beta version(s) you want to use. - `string` - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 25 more` - `"message-batches-2024-09-24"` - `"prompt-caching-2024-07-31"` - `"computer-use-2024-10-22"` - `"computer-use-2025-01-24"` - `"pdfs-2024-09-25"` - `"token-counting-2024-11-01"` - `"token-efficient-tools-2025-02-19"` - `"output-128k-2025-02-19"` - `"files-api-2025-04-14"` - `"mcp-client-2025-04-04"` - `"mcp-client-2025-11-20"` - `"dev-full-thinking-2025-05-14"` - `"interleaved-thinking-2025-05-14"` - `"code-execution-2025-05-22"` - `"extended-cache-ttl-2025-04-11"` - `"context-1m-2025-08-07"` - `"context-management-2025-06-27"` - `"model-context-window-exceeded-2025-08-26"` - `"skills-2025-10-02"` - `"fast-mode-2026-02-01"` - `"output-300k-2026-03-24"` - `"user-profiles-2026-03-24"` - `"advisor-tool-2026-03-01"` - `"managed-agents-2026-04-01"` - `"cache-diagnosis-2026-04-07"` - `"thinking-token-count-2026-05-13"` - `"server-side-fallback-2026-06-01"` - `"fallback-credit-2026-06-01"` ### Returns - `id: string` Unique identifier for the skill. The format and length of IDs may change over time. - `created_at: string` ISO 8601 timestamp of when the skill was created. - `display_title: string` Display title for the skill. This is a human-readable label that is not included in the prompt sent to the model. - `latest_version: string` The latest version identifier for the skill. This represents the most recent version of the skill that has been created. - `source: string` Source of the skill. This may be one of the following values: * `"custom"`: the skill was created by a user * `"anthropic"`: the skill was created by Anthropic - `type: string` Object type. For Skills, this is always `"skill"`. - `updated_at: string` ISO 8601 timestamp of when the skill was last updated. ### Example ```http curl https://api.anthropic.com/v1/skills \ -X POST \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: skills-2025-10-02' \ -H "X-Api-Key: $ANTHROPIC_API_KEY" ``` #### Response ```json { "id": "skill_01JAbcdefghijklmnopqrstuvw", "created_at": "2024-10-30T23:58:27.427722Z", "display_title": "My Custom Skill", "latest_version": "1759178010641129", "source": "custom", "type": "type", "updated_at": "2024-10-30T23:58:27.427722Z" } ``` ## List Skills **get** `/v1/skills` List Skills ### Query Parameters - `limit: optional number` Number of results to return per page. Maximum value is 100. Defaults to 20. - `page: optional string` Pagination token for fetching a specific page of results. Pass the value from a previous response's `next_page` field to get the next page of results. - `source: optional string` Filter skills by source. If provided, only skills from the specified source will be returned: * `"custom"`: only return user-created skills * `"anthropic"`: only return Anthropic-created skills ### Header Parameters - `"anthropic-beta": optional array of AnthropicBeta` Optional header to specify the beta version(s) you want to use. - `string` - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 25 more` - `"message-batches-2024-09-24"` - `"prompt-caching-2024-07-31"` - `"computer-use-2024-10-22"` - `"computer-use-2025-01-24"` - `"pdfs-2024-09-25"` - `"token-counting-2024-11-01"` - `"token-efficient-tools-2025-02-19"` - `"output-128k-2025-02-19"` - `"files-api-2025-04-14"` - `"mcp-client-2025-04-04"` - `"mcp-client-2025-11-20"` - `"dev-full-thinking-2025-05-14"` - `"interleaved-thinking-2025-05-14"` - `"code-execution-2025-05-22"` - `"extended-cache-ttl-2025-04-11"` - `"context-1m-2025-08-07"` - `"context-management-2025-06-27"` - `"model-context-window-exceeded-2025-08-26"` - `"skills-2025-10-02"` - `"fast-mode-2026-02-01"` - `"output-300k-2026-03-24"` - `"user-profiles-2026-03-24"` - `"advisor-tool-2026-03-01"` - `"managed-agents-2026-04-01"` - `"cache-diagnosis-2026-04-07"` - `"thinking-token-count-2026-05-13"` - `"server-side-fallback-2026-06-01"` - `"fallback-credit-2026-06-01"` ### Returns - `data: array of object { id, created_at, display_title, 4 more }` List of skills. - `id: string` Unique identifier for the skill. The format and length of IDs may change over time. - `created_at: string` ISO 8601 timestamp of when the skill was created. - `display_title: string` Display title for the skill. This is a human-readable label that is not included in the prompt sent to the model. - `latest_version: string` The latest version identifier for the skill. This represents the most recent version of the skill that has been created. - `source: string` Source of the skill. This may be one of the following values: * `"custom"`: the skill was created by a user * `"anthropic"`: the skill was created by Anthropic - `type: string` Object type. For Skills, this is always `"skill"`. - `updated_at: string` ISO 8601 timestamp of when the skill was last updated. - `has_more: boolean` Whether there are more results available. If `true`, there are additional results that can be fetched using the `next_page` token. - `next_page: string` Token for fetching the next page of results. If `null`, there are no more results available. Pass this value to the `page_token` parameter in the next request to get the next page. ### Example ```http curl https://api.anthropic.com/v1/skills \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: skills-2025-10-02' \ -H "X-Api-Key: $ANTHROPIC_API_KEY" ``` #### Response ```json { "data": [ { "id": "skill_01JAbcdefghijklmnopqrstuvw", "created_at": "2024-10-30T23:58:27.427722Z", "display_title": "My Custom Skill", "latest_version": "1759178010641129", "source": "custom", "type": "type", "updated_at": "2024-10-30T23:58:27.427722Z" } ], "has_more": true, "next_page": "page_MjAyNS0wNS0xNFQwMDowMDowMFo=" } ``` ## Get Skill **get** `/v1/skills/{skill_id}` Get Skill ### Path Parameters - `skill_id: string` Unique identifier for the skill. The format and length of IDs may change over time. ### Header Parameters - `"anthropic-beta": optional array of AnthropicBeta` Optional header to specify the beta version(s) you want to use. - `string` - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 25 more` - `"message-batches-2024-09-24"` - `"prompt-caching-2024-07-31"` - `"computer-use-2024-10-22"` - `"computer-use-2025-01-24"` - `"pdfs-2024-09-25"` - `"token-counting-2024-11-01"` - `"token-efficient-tools-2025-02-19"` - `"output-128k-2025-02-19"` - `"files-api-2025-04-14"` - `"mcp-client-2025-04-04"` - `"mcp-client-2025-11-20"` - `"dev-full-thinking-2025-05-14"` - `"interleaved-thinking-2025-05-14"` - `"code-execution-2025-05-22"` - `"extended-cache-ttl-2025-04-11"` - `"context-1m-2025-08-07"` - `"context-management-2025-06-27"` - `"model-context-window-exceeded-2025-08-26"` - `"skills-2025-10-02"` - `"fast-mode-2026-02-01"` - `"output-300k-2026-03-24"` - `"user-profiles-2026-03-24"` - `"advisor-tool-2026-03-01"` - `"managed-agents-2026-04-01"` - `"cache-diagnosis-2026-04-07"` - `"thinking-token-count-2026-05-13"` - `"server-side-fallback-2026-06-01"` - `"fallback-credit-2026-06-01"` ### Returns - `id: string` Unique identifier for the skill. The format and length of IDs may change over time. - `created_at: string` ISO 8601 timestamp of when the skill was created. - `display_title: string` Display title for the skill. This is a human-readable label that is not included in the prompt sent to the model. - `latest_version: string` The latest version identifier for the skill. This represents the most recent version of the skill that has been created. - `source: string` Source of the skill. This may be one of the following values: * `"custom"`: the skill was created by a user * `"anthropic"`: the skill was created by Anthropic - `type: string` Object type. For Skills, this is always `"skill"`. - `updated_at: string` ISO 8601 timestamp of when the skill was last updated. ### Example ```http curl https://api.anthropic.com/v1/skills/$SKILL_ID \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: skills-2025-10-02' \ -H "X-Api-Key: $ANTHROPIC_API_KEY" ``` #### Response ```json { "id": "skill_01JAbcdefghijklmnopqrstuvw", "created_at": "2024-10-30T23:58:27.427722Z", "display_title": "My Custom Skill", "latest_version": "1759178010641129", "source": "custom", "type": "type", "updated_at": "2024-10-30T23:58:27.427722Z" } ``` ## Delete Skill **delete** `/v1/skills/{skill_id}` Delete Skill ### Path Parameters - `skill_id: string` Unique identifier for the skill. The format and length of IDs may change over time. ### Header Parameters - `"anthropic-beta": optional array of AnthropicBeta` Optional header to specify the beta version(s) you want to use. - `string` - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 25 more` - `"message-batches-2024-09-24"` - `"prompt-caching-2024-07-31"` - `"computer-use-2024-10-22"` - `"computer-use-2025-01-24"` - `"pdfs-2024-09-25"` - `"token-counting-2024-11-01"` - `"token-efficient-tools-2025-02-19"` - `"output-128k-2025-02-19"` - `"files-api-2025-04-14"` - `"mcp-client-2025-04-04"` - `"mcp-client-2025-11-20"` - `"dev-full-thinking-2025-05-14"` - `"interleaved-thinking-2025-05-14"` - `"code-execution-2025-05-22"` - `"extended-cache-ttl-2025-04-11"` - `"context-1m-2025-08-07"` - `"context-management-2025-06-27"` - `"model-context-window-exceeded-2025-08-26"` - `"skills-2025-10-02"` - `"fast-mode-2026-02-01"` - `"output-300k-2026-03-24"` - `"user-profiles-2026-03-24"` - `"advisor-tool-2026-03-01"` - `"managed-agents-2026-04-01"` - `"cache-diagnosis-2026-04-07"` - `"thinking-token-count-2026-05-13"` - `"server-side-fallback-2026-06-01"` - `"fallback-credit-2026-06-01"` ### Returns - `id: string` Unique identifier for the skill. The format and length of IDs may change over time. - `type: string` Deleted object type. For Skills, this is always `"skill_deleted"`. ### Example ```http curl https://api.anthropic.com/v1/skills/$SKILL_ID \ -X DELETE \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: skills-2025-10-02' \ -H "X-Api-Key: $ANTHROPIC_API_KEY" ``` #### Response ```json { "id": "skill_01JAbcdefghijklmnopqrstuvw", "type": "type" } ``` ## Domain Types ### Skill Create Response - `SkillCreateResponse object { id, created_at, display_title, 4 more }` - `id: string` Unique identifier for the skill. The format and length of IDs may change over time. - `created_at: string` ISO 8601 timestamp of when the skill was created. - `display_title: string` Display title for the skill. This is a human-readable label that is not included in the prompt sent to the model. - `latest_version: string` The latest version identifier for the skill. This represents the most recent version of the skill that has been created. - `source: string` Source of the skill. This may be one of the following values: * `"custom"`: the skill was created by a user * `"anthropic"`: the skill was created by Anthropic - `type: string` Object type. For Skills, this is always `"skill"`. - `updated_at: string` ISO 8601 timestamp of when the skill was last updated. ### Skill List Response - `SkillListResponse object { id, created_at, display_title, 4 more }` - `id: string` Unique identifier for the skill. The format and length of IDs may change over time. - `created_at: string` ISO 8601 timestamp of when the skill was created. - `display_title: string` Display title for the skill. This is a human-readable label that is not included in the prompt sent to the model. - `latest_version: string` The latest version identifier for the skill. This represents the most recent version of the skill that has been created. - `source: string` Source of the skill. This may be one of the following values: * `"custom"`: the skill was created by a user * `"anthropic"`: the skill was created by Anthropic - `type: string` Object type. For Skills, this is always `"skill"`. - `updated_at: string` ISO 8601 timestamp of when the skill was last updated. ### Skill Retrieve Response - `SkillRetrieveResponse object { id, created_at, display_title, 4 more }` - `id: string` Unique identifier for the skill. The format and length of IDs may change over time. - `created_at: string` ISO 8601 timestamp of when the skill was created. - `display_title: string` Display title for the skill. This is a human-readable label that is not included in the prompt sent to the model. - `latest_version: string` The latest version identifier for the skill. This represents the most recent version of the skill that has been created. - `source: string` Source of the skill. This may be one of the following values: * `"custom"`: the skill was created by a user * `"anthropic"`: the skill was created by Anthropic - `type: string` Object type. For Skills, this is always `"skill"`. - `updated_at: string` ISO 8601 timestamp of when the skill was last updated. ### Skill Delete Response - `SkillDeleteResponse object { id, type }` - `id: string` Unique identifier for the skill. The format and length of IDs may change over time. - `type: string` Deleted object type. For Skills, this is always `"skill_deleted"`. # Versions ## Create Skill Version **post** `/v1/skills/{skill_id}/versions` Create Skill Version ### Path Parameters - `skill_id: string` Unique identifier for the skill. The format and length of IDs may change over time. ### Header Parameters - `"anthropic-beta": optional array of AnthropicBeta` Optional header to specify the beta version(s) you want to use. - `string` - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 25 more` - `"message-batches-2024-09-24"` - `"prompt-caching-2024-07-31"` - `"computer-use-2024-10-22"` - `"computer-use-2025-01-24"` - `"pdfs-2024-09-25"` - `"token-counting-2024-11-01"` - `"token-efficient-tools-2025-02-19"` - `"output-128k-2025-02-19"` - `"files-api-2025-04-14"` - `"mcp-client-2025-04-04"` - `"mcp-client-2025-11-20"` - `"dev-full-thinking-2025-05-14"` - `"interleaved-thinking-2025-05-14"` - `"code-execution-2025-05-22"` - `"extended-cache-ttl-2025-04-11"` - `"context-1m-2025-08-07"` - `"context-management-2025-06-27"` - `"model-context-window-exceeded-2025-08-26"` - `"skills-2025-10-02"` - `"fast-mode-2026-02-01"` - `"output-300k-2026-03-24"` - `"user-profiles-2026-03-24"` - `"advisor-tool-2026-03-01"` - `"managed-agents-2026-04-01"` - `"cache-diagnosis-2026-04-07"` - `"thinking-token-count-2026-05-13"` - `"server-side-fallback-2026-06-01"` - `"fallback-credit-2026-06-01"` ### Returns - `id: string` Unique identifier for the skill version. The format and length of IDs may change over time. - `created_at: string` ISO 8601 timestamp of when the skill version was created. - `description: string` Description of the skill version. This is extracted from the SKILL.md file in the skill upload. - `directory: string` Directory name of the skill version. This is the top-level directory name that was extracted from the uploaded files. - `name: string` Human-readable name of the skill version. This is extracted from the SKILL.md file in the skill upload. - `skill_id: string` Identifier for the skill that this version belongs to. - `type: string` Object type. For Skill Versions, this is always `"skill_version"`. - `version: string` Version identifier for the skill. Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). ### Example ```http curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions \ -X POST \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: skills-2025-10-02' \ -H "X-Api-Key: $ANTHROPIC_API_KEY" ``` #### Response ```json { "id": "skillver_01JAbcdefghijklmnopqrstuvw", "created_at": "2024-10-30T23:58:27.427722Z", "description": "A custom skill for doing something useful", "directory": "my-skill", "name": "my-skill", "skill_id": "skill_01JAbcdefghijklmnopqrstuvw", "type": "type", "version": "1759178010641129" } ``` ## List Skill Versions **get** `/v1/skills/{skill_id}/versions` List Skill Versions ### Path Parameters - `skill_id: string` Unique identifier for the skill. The format and length of IDs may change over time. ### Query Parameters - `limit: optional number` Number of items to return per page. Defaults to `20`. Ranges from `1` to `1000`. - `page: optional string` Optionally set to the `next_page` token from the previous response. ### Header Parameters - `"anthropic-beta": optional array of AnthropicBeta` Optional header to specify the beta version(s) you want to use. - `string` - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 25 more` - `"message-batches-2024-09-24"` - `"prompt-caching-2024-07-31"` - `"computer-use-2024-10-22"` - `"computer-use-2025-01-24"` - `"pdfs-2024-09-25"` - `"token-counting-2024-11-01"` - `"token-efficient-tools-2025-02-19"` - `"output-128k-2025-02-19"` - `"files-api-2025-04-14"` - `"mcp-client-2025-04-04"` - `"mcp-client-2025-11-20"` - `"dev-full-thinking-2025-05-14"` - `"interleaved-thinking-2025-05-14"` - `"code-execution-2025-05-22"` - `"extended-cache-ttl-2025-04-11"` - `"context-1m-2025-08-07"` - `"context-management-2025-06-27"` - `"model-context-window-exceeded-2025-08-26"` - `"skills-2025-10-02"` - `"fast-mode-2026-02-01"` - `"output-300k-2026-03-24"` - `"user-profiles-2026-03-24"` - `"advisor-tool-2026-03-01"` - `"managed-agents-2026-04-01"` - `"cache-diagnosis-2026-04-07"` - `"thinking-token-count-2026-05-13"` - `"server-side-fallback-2026-06-01"` - `"fallback-credit-2026-06-01"` ### Returns - `data: array of object { id, created_at, description, 5 more }` List of skill versions. - `id: string` Unique identifier for the skill version. The format and length of IDs may change over time. - `created_at: string` ISO 8601 timestamp of when the skill version was created. - `description: string` Description of the skill version. This is extracted from the SKILL.md file in the skill upload. - `directory: string` Directory name of the skill version. This is the top-level directory name that was extracted from the uploaded files. - `name: string` Human-readable name of the skill version. This is extracted from the SKILL.md file in the skill upload. - `skill_id: string` Identifier for the skill that this version belongs to. - `type: string` Object type. For Skill Versions, this is always `"skill_version"`. - `version: string` Version identifier for the skill. Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). - `has_more: boolean` Indicates if there are more results in the requested page direction. - `next_page: string` Token to provide in as `page` in the subsequent request to retrieve the next page of data. ### Example ```http curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: skills-2025-10-02' \ -H "X-Api-Key: $ANTHROPIC_API_KEY" ``` #### Response ```json { "data": [ { "id": "skillver_01JAbcdefghijklmnopqrstuvw", "created_at": "2024-10-30T23:58:27.427722Z", "description": "A custom skill for doing something useful", "directory": "my-skill", "name": "my-skill", "skill_id": "skill_01JAbcdefghijklmnopqrstuvw", "type": "type", "version": "1759178010641129" } ], "has_more": true, "next_page": "page_MjAyNS0wNS0xNFQwMDowMDowMFo=" } ``` ## Download Skill Version Content **get** `/v1/skills/{skill_id}/versions/{version}/content` Download a skill version's content as a zip archive. ### Path Parameters - `skill_id: string` Unique identifier for the skill. The format and length of IDs may change over time. - `version: string` Version identifier for the skill. Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). ### Header Parameters - `"anthropic-beta": optional array of AnthropicBeta` Optional header to specify the beta version(s) you want to use. - `string` - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 25 more` - `"message-batches-2024-09-24"` - `"prompt-caching-2024-07-31"` - `"computer-use-2024-10-22"` - `"computer-use-2025-01-24"` - `"pdfs-2024-09-25"` - `"token-counting-2024-11-01"` - `"token-efficient-tools-2025-02-19"` - `"output-128k-2025-02-19"` - `"files-api-2025-04-14"` - `"mcp-client-2025-04-04"` - `"mcp-client-2025-11-20"` - `"dev-full-thinking-2025-05-14"` - `"interleaved-thinking-2025-05-14"` - `"code-execution-2025-05-22"` - `"extended-cache-ttl-2025-04-11"` - `"context-1m-2025-08-07"` - `"context-management-2025-06-27"` - `"model-context-window-exceeded-2025-08-26"` - `"skills-2025-10-02"` - `"fast-mode-2026-02-01"` - `"output-300k-2026-03-24"` - `"user-profiles-2026-03-24"` - `"advisor-tool-2026-03-01"` - `"managed-agents-2026-04-01"` - `"cache-diagnosis-2026-04-07"` - `"thinking-token-count-2026-05-13"` - `"server-side-fallback-2026-06-01"` - `"fallback-credit-2026-06-01"` ### Example ```http curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions/$VERSION/content \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: skills-2025-10-02' \ -H "X-Api-Key: $ANTHROPIC_API_KEY" ``` ## Get Skill Version **get** `/v1/skills/{skill_id}/versions/{version}` Get Skill Version ### Path Parameters - `skill_id: string` Unique identifier for the skill. The format and length of IDs may change over time. - `version: string` Version identifier for the skill. Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). ### Header Parameters - `"anthropic-beta": optional array of AnthropicBeta` Optional header to specify the beta version(s) you want to use. - `string` - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 25 more` - `"message-batches-2024-09-24"` - `"prompt-caching-2024-07-31"` - `"computer-use-2024-10-22"` - `"computer-use-2025-01-24"` - `"pdfs-2024-09-25"` - `"token-counting-2024-11-01"` - `"token-efficient-tools-2025-02-19"` - `"output-128k-2025-02-19"` - `"files-api-2025-04-14"` - `"mcp-client-2025-04-04"` - `"mcp-client-2025-11-20"` - `"dev-full-thinking-2025-05-14"` - `"interleaved-thinking-2025-05-14"` - `"code-execution-2025-05-22"` - `"extended-cache-ttl-2025-04-11"` - `"context-1m-2025-08-07"` - `"context-management-2025-06-27"` - `"model-context-window-exceeded-2025-08-26"` - `"skills-2025-10-02"` - `"fast-mode-2026-02-01"` - `"output-300k-2026-03-24"` - `"user-profiles-2026-03-24"` - `"advisor-tool-2026-03-01"` - `"managed-agents-2026-04-01"` - `"cache-diagnosis-2026-04-07"` - `"thinking-token-count-2026-05-13"` - `"server-side-fallback-2026-06-01"` - `"fallback-credit-2026-06-01"` ### Returns - `id: string` Unique identifier for the skill version. The format and length of IDs may change over time. - `created_at: string` ISO 8601 timestamp of when the skill version was created. - `description: string` Description of the skill version. This is extracted from the SKILL.md file in the skill upload. - `directory: string` Directory name of the skill version. This is the top-level directory name that was extracted from the uploaded files. - `name: string` Human-readable name of the skill version. This is extracted from the SKILL.md file in the skill upload. - `skill_id: string` Identifier for the skill that this version belongs to. - `type: string` Object type. For Skill Versions, this is always `"skill_version"`. - `version: string` Version identifier for the skill. Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). ### Example ```http curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions/$VERSION \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: skills-2025-10-02' \ -H "X-Api-Key: $ANTHROPIC_API_KEY" ``` #### Response ```json { "id": "skillver_01JAbcdefghijklmnopqrstuvw", "created_at": "2024-10-30T23:58:27.427722Z", "description": "A custom skill for doing something useful", "directory": "my-skill", "name": "my-skill", "skill_id": "skill_01JAbcdefghijklmnopqrstuvw", "type": "type", "version": "1759178010641129" } ``` ## Delete Skill Version **delete** `/v1/skills/{skill_id}/versions/{version}` Delete Skill Version ### Path Parameters - `skill_id: string` Unique identifier for the skill. The format and length of IDs may change over time. - `version: string` Version identifier for the skill. Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). ### Header Parameters - `"anthropic-beta": optional array of AnthropicBeta` Optional header to specify the beta version(s) you want to use. - `string` - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 25 more` - `"message-batches-2024-09-24"` - `"prompt-caching-2024-07-31"` - `"computer-use-2024-10-22"` - `"computer-use-2025-01-24"` - `"pdfs-2024-09-25"` - `"token-counting-2024-11-01"` - `"token-efficient-tools-2025-02-19"` - `"output-128k-2025-02-19"` - `"files-api-2025-04-14"` - `"mcp-client-2025-04-04"` - `"mcp-client-2025-11-20"` - `"dev-full-thinking-2025-05-14"` - `"interleaved-thinking-2025-05-14"` - `"code-execution-2025-05-22"` - `"extended-cache-ttl-2025-04-11"` - `"context-1m-2025-08-07"` - `"context-management-2025-06-27"` - `"model-context-window-exceeded-2025-08-26"` - `"skills-2025-10-02"` - `"fast-mode-2026-02-01"` - `"output-300k-2026-03-24"` - `"user-profiles-2026-03-24"` - `"advisor-tool-2026-03-01"` - `"managed-agents-2026-04-01"` - `"cache-diagnosis-2026-04-07"` - `"thinking-token-count-2026-05-13"` - `"server-side-fallback-2026-06-01"` - `"fallback-credit-2026-06-01"` ### Returns - `id: string` Version identifier for the skill. Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). - `type: string` Deleted object type. For Skill Versions, this is always `"skill_version_deleted"`. ### Example ```http curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions/$VERSION \ -X DELETE \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: skills-2025-10-02' \ -H "X-Api-Key: $ANTHROPIC_API_KEY" ``` #### Response ```json { "id": "1759178010641129", "type": "type" } ``` ## Domain Types ### Version Create Response - `VersionCreateResponse object { id, created_at, description, 5 more }` - `id: string` Unique identifier for the skill version. The format and length of IDs may change over time. - `created_at: string` ISO 8601 timestamp of when the skill version was created. - `description: string` Description of the skill version. This is extracted from the SKILL.md file in the skill upload. - `directory: string` Directory name of the skill version. This is the top-level directory name that was extracted from the uploaded files. - `name: string` Human-readable name of the skill version. This is extracted from the SKILL.md file in the skill upload. - `skill_id: string` Identifier for the skill that this version belongs to. - `type: string` Object type. For Skill Versions, this is always `"skill_version"`. - `version: string` Version identifier for the skill. Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). ### Version List Response - `VersionListResponse object { id, created_at, description, 5 more }` - `id: string` Unique identifier for the skill version. The format and length of IDs may change over time. - `created_at: string` ISO 8601 timestamp of when the skill version was created. - `description: string` Description of the skill version. This is extracted from the SKILL.md file in the skill upload. - `directory: string` Directory name of the skill version. This is the top-level directory name that was extracted from the uploaded files. - `name: string` Human-readable name of the skill version. This is extracted from the SKILL.md file in the skill upload. - `skill_id: string` Identifier for the skill that this version belongs to. - `type: string` Object type. For Skill Versions, this is always `"skill_version"`. - `version: string` Version identifier for the skill. Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). ### Version Retrieve Response - `VersionRetrieveResponse object { id, created_at, description, 5 more }` - `id: string` Unique identifier for the skill version. The format and length of IDs may change over time. - `created_at: string` ISO 8601 timestamp of when the skill version was created. - `description: string` Description of the skill version. This is extracted from the SKILL.md file in the skill upload. - `directory: string` Directory name of the skill version. This is the top-level directory name that was extracted from the uploaded files. - `name: string` Human-readable name of the skill version. This is extracted from the SKILL.md file in the skill upload. - `skill_id: string` Identifier for the skill that this version belongs to. - `type: string` Object type. For Skill Versions, this is always `"skill_version"`. - `version: string` Version identifier for the skill. Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). ### Version Delete Response - `VersionDeleteResponse object { id, type }` - `id: string` Version identifier for the skill. Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). - `type: string` Deleted object type. For Skill Versions, this is always `"skill_version_deleted"`.