---
type: api
title: Delete a skill
description: 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](https://www.elastic.co/docs/explore-analyze/ai-features/agent-builder/skills).<br/><br/>[Required authorization] Route required privileges: agentBuilder:manageSkills.
url: https://www.elastic.co/elastic/docs-builder/docs/4493/api/doc/kibana/v0/operation/operation-delete-agent-builder-skills-skillid
resource: https://www.elastic.co/elastic/docs-builder/docs/4493/api/doc/kibana/v0/operation/operation-delete-agent-builder-skills-skillid
products:
  - Kibana
---

# Delete a skill

Availability: Experimental since 9.4

- Server: `https://{kibana_url}`

## Paths

- `DELETE` `/api/agent_builder/skills/{skillId}`

#### Path parameters

- `skillId` (string · min length: 1 · max length: 512) — required
  The unique identifier of the skill.

## Description

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](https://www.elastic.co/docs/explore-analyze/ai-features/agent-builder/skills).

## Required authorization

- Privileges: `agentBuilder:manageSkills`

## Authentication

- Api key: `Authorization: <value>`
  These APIs use key-based authentication. You must create an API key and use the encoded value in the request header. For example: `Authorization: ApiKey base64AccessApiKey`
- Basic: `Authorization: Basic <credentials>`

## Query string parameters

- `force` (boolean · default: false) — optional
  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

Indicates a successful response

`application/json`

## Code examples

#### Console

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

#### curl

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

## Response examples

#### Delete skill response

Example response showing that the deletion operation was successful

```json
{
  "success": true
}
```