Claude Platform Docs

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

Identifies the skill version by its version ID.

Requests carrying the skills-2025-10-02 beta header address versions by their Unix epoch timestamp instead (e.g., "1759178010641129").

Headers
"anthropic-version": optional string

The version of the Claude API you want to use.

Read more about versioning and our version history here.

"anthropic-workspace-id": optional string

Optional header to select the Workspace for this request. The value is a Workspace ID (for example, wrkspc_011CZkZaBF1tNoB5wlCeusgy).

Only needed for credentials that can act on more than one Workspace. A credential that belongs to a specific Workspace may omit it; if sent, it must match that Workspace.

Returns
DeletedSkillVersion object{ type: "skill_version_deleted", id }
type: "skill_version_deleted"

Deleted object type.

For Skill Versions, this is always "skill_version_deleted".

defaultskill_version_deleted
id: string

Unique identifier for this Skill Version. The id addresses the version in paths and pins it in references.

Errors

Any method can also return the general HTTP errors.

Each code below is the value of error.details.error_code in the response body.

error code claude_code_key_creator_not_memberHTTP status 400

The API key belongs to the Claude Code workspace, and the user who created it is no longer a member of the organization or of that workspace.

error code organization_on_holdHTTP status 400

Anthropic has disabled the organization for trust and safety reasons. An organization disabled for any other reason, such as billing, does not get this code. appeal_url, when present, is where the organization can appeal.

Delete Skill Version
curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions/$VERSION \
    -X DELETE \
    -H 'anthropic-version: 2026-10-21' \
    -H "Authorization: Bearer $ANTHROPIC_API_KEY"
Returns Examples
Response 200
{
  "id": "id",
  "type": "skill_version_deleted"
}