Sample - OpenAI API
DELETE/skills/{skill_id}/versions/{version}

Delete a skill version

Deletes a specific version of a skill. Supply skill_id and version to identify the version to remove. The response confirms deletion and includes the deleted version's identifier and version number.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

2 parameters
skill_idstringrequired
The identifier of the skill whose version you want to delete.
versionstringrequired
The version number of the skill to delete.

2 status codes
200Returns a deletion confirmation object containing the deleted object type, a boolean deletion indicator, the version identifier, and the deleted version number.
objectstringrequired
Allowed:skill.version.deletedDefault:skill.version.deleted
deletedbooleanrequired
idstringrequired
versionstringrequired
The deleted skill version.
429Returned when the request was rejected because the rate limit was exceeded.
errorobjectrequired

Error handling

A 429 is returned when the request exceeds the rate limit. skill_id must identify the skill and version must specify the version to delete.