Delete a specific skill version.
DELETE /api/v1/cloud/skills/{skill_id}/versions/{version}
Deletes the specified skill version and returns a deletion confirmation.
Headers
| Header | Required | Description |
|---|---|---|
Authorization | Yes | Bearer <PAT or SAT> |
Path parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
skill_id | string | Yes | Skill unique identifier |
version | string | Yes | Version identifier. Only numeric timestamps are accepted (same rules as Get a skill version) |
Example request
Example response
HTTP 200 OK
id is the deleted version identifier; successful deletion is signalled by "type": "skill_version_deleted".
Behavior
- When the latest version is deleted,
latest_versionfalls back to the next-newest version; it becomesnullwhen all versions are deleted. - Deleting the same version again returns 404.
Errors
| HTTP | Type | Trigger |
|---|---|---|
| 400 | invalid_request_error | Non-numeric version (including latest) |
| 401 | TOKEN_INVALID | Missing or invalid authentication token |
| 404 | not_found_error | Skill does not exist, or the version does not exist / has already been deleted (repeated deletion also returns 404) |