API ReferenceSkills

Delete Skill

Beta

Delete a skill. Refused with 409 skill_in_use while any agent still has it attached: deleting it would change every one of their prompts at once, which is what the version pin exists to prevent. Detach it first. Dark launch: requires the skills_access entitlement (402 skills_not_in_plan otherwise).

Authentication

AuthorizationBearer

Enter your API key with the Bearer prefix, e.g. ‘Bearer sk_…’.

Path parameters

skill_idstringRequired

Skill id (prefixed external id, skill_...).

Headers

Speechify-VersionstringOptional

Response

Deleted.

Errors

401
Unauthorized Error
402
Payment Required Error
404
Not Found Error
409
Conflict Error