Delete Skill Version

Changed on
delete/v1/skills/{skill_id}/versions/{version}?beta=true

Request

Path parameters

skill_idstring required

Unique identifier for the skill.

The format and length of IDs may change over time.

versionstring required

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-versionstring

The version of the Claude API you want to use.

Read more about versioning and our version history here.

anthropic-workspace-idstring

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.

Response

Successful Response

idstring required

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

type'skill_version_deleted' required

Deleted object type.

For Skill Versions, this is always "skill_version_deleted".

Changes

    • info

      added the enum value admin-user-sign-out-2026-10-08 to the property items/anyOf[subschema #2]/ of the header request parameter anthropic-beta

    • info

      added the enum value experimental-claude-tag-2026-10-21 to the property items/anyOf[subschema #2]/ of the header request parameter anthropic-beta