Sample - OpenAI API
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.

1 parameter
skill_idstringrequired
The identifier of the skill to delete.

2 status codes
200Returns a deletion object with `object` set to `skill.deleted`, a `deleted` confirmation, and the deleted skill `id`.
objectstringrequired
Allowed:skill.deletedDefault:skill.deleted
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.