Delete a skill

Base URL: https://{kibana_url}

DELETE /api/agent_builder/skills/{skillId}
DELETE /s/{space_id}/api/agent_builder/skills/{skillId}

Auth

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.

Required authorization

Privileges agentBuilder:manageSkills

Path parameters

space_id string optional: An identifier for the space. If space_id is not provided in the URL, the default space is used. Refer to Spaces for more information.
skillId string · min length: 1 · max length: 512 required: The unique identifier of the skill.

Query parameters

force boolean · default: false: 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.

Header parameters

kbn-xsrf string required: A required header to protect against CSRF attacks

Response

200

Indicates a successful response

application/json

Base URL: https://{kibana_url}

Examples

Request Console 1 / 2 languages

Console Kibana Dev Tools

DELETE kbn:/api/agent_builder/skills/{skillId}

curl Shell

curl \
  -X DELETE "https://${KIBANA_URL}/api/agent_builder/skills/{skillId}?force=false" \
  -H "Authorization: ApiKey ${API_KEY}" \
  -H "kbn-xsrf: true"

Response

Example response showing that the deletion operation was successful

{
  "success": true
}