Deletes a custom Skill and all its versions. The operation is irreversible.
Endpoint
DELETE /api/v1/skills/{skill_id}
Deletes a custom Skill and all its versions. The operation is irreversible. Agents that have mounted an older version are not affected.
Request parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| skill_id | string | Yes | Custom Skill ID |
Response
Returns a SkillDeletedResponse.
| Field | Type | Description |
|---|---|---|
| id | string | ID of the deleted Skill |
| type | string | Always skill_deleted |
Example
Errors
| HTTP status | error_code | Description |
|---|---|---|
| 401 | WORKSPACE_ID_ILLEGAL | Identity information is missing or invalid |
| 400 | SKILL_ID_IS_NULL | skill_id is blank |
| 500 | SKILL_NOT_EXIST | The Skill does not exist, is deleted, or is inaccessible. A repeated delete returns this error |
| 500 | SKILL_DELETE_OFFICIAL_NOT_ALLOWED | Attempted to delete an official Skill |
| 500 | SKILL_DELETE_ERROR | Failed to delete the Skill |