Delete Skill Version

skills.versions.delete(version, **kwargs) -> DeletedSkillVersion

DELETE/v1/skills/{skill_id}/versions/{version}

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").

Returns

class DeletedSkillVersion { id, type }

id: String

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

type: :skill_version_deleted

Deleted object type.

For Skill Versions, this is always "skill_version_deleted".

Delete Skill Version

require "anthropic"

anthropic = Anthropic::Client.new(api_key: "my-anthropic-api-key")

deleted_skill_version = anthropic.skills.versions.delete("version", skill_id: "skill_id")

puts(deleted_skill_version)

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

Returns Examples

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