spb/doc-api

1---2title: Delete Skill Version3url: https://platform.claude.com/docs/en/api/beta/skills/versions/delete4---56# Delete Skill Version78**DELETE** `/v1/skills/{skill_id}/versions/{version}`910Delete Skill Version1112## Path parameters1314- `skill_id: string`1516  Unique identifier for the skill.1718  The format and length of IDs may change over time.1920- `version: string`2122  Identifies the skill version by its version ID.2324  Requests carrying the `skills-2025-10-02` beta header address versions by their Unix epoch timestamp instead (e.g., "1759178010641129").2526## Headers2728- `"anthropic-beta": optional array of AnthropicBeta`2930  Optional header to specify the beta version(s) you want to use.3132  - `string`3334  - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 43 more`3536    - `"message-batches-2024-09-24"`3738    - `"prompt-caching-2024-07-31"`3940    - `"computer-use-2024-10-22"`4142    - `"computer-use-2025-01-24"`4344    - `"pdfs-2024-09-25"`4546    - `"token-counting-2024-11-01"`4748    - `"token-efficient-tools-2025-02-19"`4950    - `"output-128k-2025-02-19"`5152    - `"files-api-2025-04-14"`5354    - `"mcp-client-2025-04-04"`5556    - `"mcp-client-2025-11-20"`5758    - `"dev-full-thinking-2025-05-14"`5960    - `"interleaved-thinking-2025-05-14"`6162    - `"code-execution-2025-05-22"`6364    - `"extended-cache-ttl-2025-04-11"`6566    - `"context-1m-2025-08-07"`6768    - `"context-management-2025-06-27"`6970    - `"model-context-window-exceeded-2025-08-26"`7172    - `"skills-2025-10-02"`7374    - `"fast-mode-2026-02-01"`7576    - `"output-300k-2026-03-24"`7778    - `"user-profiles-2026-03-24"`7980    - `"user-profiles-2026-08-18"`8182    - `"user-profiles-2026-09-04"`8384    - `"advisor-tool-2026-03-01"`8586    - `"managed-agents-2026-04-01"`8788    - `"cache-diagnosis-2026-04-07"`8990    - `"dreaming-2026-04-21"`9192    - `"thinking-token-count-2026-05-13"`9394    - `"server-side-fallback-2026-06-01"`9596    - `"server-side-fallback-2026-07-01"`9798    - `"fallback-credit-2026-06-01"`99100    - `"fallback-credit-2026-07-01"`101102    - `"agent-memory-2026-07-22"`103104    - `"mid-conversation-tool-changes-2026-07-01"`105106    - `"compact-2026-01-12"`107108    - `"computer-use-2025-11-24"`109110    - `"mcp-tunnels-2026-06-22"`111112    - `"structured-outputs-2025-11-13"`113114    - `"task-budgets-2026-03-13"`115116    - `"thinking-display-updates-2026-08-18"`117118    - `"ce-user-management-2026-07-13"`119120    - `"mid-conversation-output-config-2026-07-01"`121122    - `"thinking-binding-controls-2026-08-01"`123124    - `"mid-conversation-system-clear-at-2026-08-21"`125126    - `"compact-2026-09-04"`127128- `"anthropic-workspace-id": optional string`129130## Returns131132- `BetaDeletedSkillVersion object`133134  - `type: "skill_version_deleted"`135136    Deleted object type.137138    For Skill Versions, this is always `"skill_version_deleted"`.139140    default: skill_version_deleted141142  - `id: string`143144    Unique identifier for this Skill Version. The id addresses the version in145    paths and pins it in references.146147## Example148149```bash150curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions/$VERSION \151    -X DELETE \152    -H 'anthropic-version: 2023-06-01' \153    -H "X-Api-Key: $ANTHROPIC_API_KEY"154```155156### Response (200)157158```json159{160  "id": "id",161  "type": "skill_version_deleted"162}163```164