v53

latestOpenAPI 3.0.3raw.githubusercontent.com2026-08-076771,7565.2 MB
agent builder

Delete a skill

Spaces method and path for this operation:

<div><span class="operation-verb delete">delete</span>&nbsp;<span class="operation-path">/s/{space_id}/api/agent_builder/skills/{skillId}</span></div>

Refer to Spaces for more information.

Delete a user-created skill by ID. If agents still reference the skill, the request returns 409 unless force=true, which removes the skill from agents first. Built-in skills cannot be deleted. To learn more about Agent Builder skills, refer to the skills documentation.<br/><br/>[Required authorization] Route required privileges: agentBuilder:manageSkills.

delete/api/agent_builder/skills/{skillId}

Path parameters

skillIdstring required

The unique identifier of the skill.

Query parameters

forceboolean

If true, removes the skill from agents that use it and then deletes it. If false and any agent uses the skill, the request returns 409 Conflict with the list of agents.

Headers

kbn-xsrfstring required
Example:true

A required header to protect against CSRF attacks

Response

Indicates a successful response