DELETE
/skills/{skill_id}Delete a skill
Deletes a skill by its identifier. Use this endpoint when you no longer need the skill and its associated skill record. The response confirms the deletion and identifies the affected skill.
- RetriesRetries up to 2×, 500ms backoff, 30s timeout.
skill_idstringrequired
The identifier of the skill to delete.
200Returns a deletion object with `object` set to `skill.deleted`, a `deleted` confirmation, and the deleted skill `id`.
objectstringrequired
deletedbooleanrequired
idstringrequired
429Returned when the request is rejected because the rate limit has been exceeded.
errorobjectrequired
Error handling
A 429 is returned when the request exceeds the rate limit. skill_id must identify the skill you want to delete.