---
type: api
title: Delete a tool
description: Delete a tool by ID. This action cannot be undone. To learn more about Agent Builder tools, refer to the [tools documentation](https://www.elastic.co/docs/explore-analyze/ai-features/agent-builder/tools).<br/><br/>[Required authorization] Route required privileges: agentBuilder:manageTools.
url: https://www.elastic.co/elastic/docs-builder/docs/4641/api/doc/kibana/v0/operation/operation-delete-agent-builder-tools-toolid
resource: https://www.elastic.co/elastic/docs-builder/docs/4641/api/doc/kibana/v0/operation/operation-delete-agent-builder-tools-toolid
products:
  - Kibana
---

# Delete a tool

Authentication: required

Availability: Generally available since 9.2

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

## Paths

- `DELETE` `/api/agent_builder/tools/{toolId}`

#### Path parameters

- `toolId` (string) — required
  The unique identifier of the tool to delete.

## Description

Delete a tool by ID. This action cannot be undone. To learn more about Agent Builder tools, refer to the [tools documentation](https://www.elastic.co/docs/explore-analyze/ai-features/agent-builder/tools).

## Required authorization

- Privileges: `agentBuilder:manageTools`

## Query string parameters

- `force` (boolean · default: false) — optional
  If true, removes the tool from agents that use it and then deletes it. If false and any agent uses the tool, 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/tools/{toolId}
```

#### curl

```curl
curl \
  -X DELETE "https://${KIBANA_URL}/api/agent_builder/tools/{toolId}" \
  -H "Authorization: ApiKey ${API_KEY}" \
  -H "kbn-xsrf: true"
```

## Response examples

#### Delete agent response

`application/json`

Example response showing that the deletion operation was successful

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