Remove a Skill

DELETE

/skills-service/api/v2/skills/{skill_id}

Permanently removes a skill from your organization. After a successful delete, your organisation will no longer have access to it.

Auth: Requires an Authorization token.

Path Parameters

skill_id: The Ejento id of the skill to remove.

Request Body

(none)

Returns

200 OK with the final skill snapshot and the deleted name.

Common Errors

404 skill_not_found — no skill with this name exists.

403 system_curated_immutable — skill is system-curated.

403 permission_denied — caller lacks permission to manage skills.

500 delete_partial — rare partial-failure where the skill was only partially removed. Retry the same DELETE call to finish cleanup; it is safe to call again.

Current Version 2.0.0

Request

Path Params

Header Params

Responses

🟢200

application/json

Skill deleted

Bodyapplication/json

🟠400

🟠401

🟠403

🟠404

🟠422

🔴500

🔴503

Request Example

Shell

JavaScript

Java

Swift

curl --location --globoff --request DELETE 'https:///skills-service/api/v2/skills/' \
--header 'Ocp-Apim-Subscription-Key: ' \
--header 'Authorization: Bearer '

Response Example

200 - Example 1

{
    "data": {
        "skill": {
            "category": "Engineering",
            "created_by": "[email protected]",
            "created_on": "2026-05-21T12:00:00Z",
            "description": "My skill description.",
            "id": 42,
            "is_default": false,
            "is_draft": false,
            "is_enabled": true,
            "modified_by": "[email protected]",
            "modified_on": "2026-05-21T12:00:00Z",
            "name": "my-skill",
            "org_id": 7,
            "type": "bundle"
        },
        "skill_name": "my-skill"
    },
    "message": "Skill 'my-skill' deleted",
    "success": true
}

Edit Skill Metadata or SKILL.md Body (Single-File Skills)

Get a Skill (detail view with content)