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-workspace-id": optional string

Returns

• DeletedSkillVersion object

  • type: "skill_version_deleted"

    Deleted object type.

    For Skill Versions, this is always "skill_version_deleted".

    default: skill_version_deleted

  • id: string

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

Example

curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions/$VERSION \
    -X DELETE \
    -H 'anthropic-version: 2023-06-01' \
    -H "X-Api-Key: $ANTHROPIC_API_KEY"

Response (200)

{
  "id": "id",
  "type": "skill_version_deleted"
}