---
type: api
title: Delete a tool
description: **Spaces method and path for this operation:**
url: https://www.elastic.co/elastic/docs-builder/docs/4493/api/doc/kibana/operation/operation-delete-agent-builder-tools-toolid
resource: https://www.elastic.co/elastic/docs-builder/docs/4493/api/doc/kibana/operation/operation-delete-agent-builder-tools-toolid
products:
  - Kibana
---

# Delete a tool

Availability: Generally available since 9.2

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

## Paths

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

#### Path parameters

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

## Description

Refer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.

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`

## 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 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

Example response showing that the deletion operation was successful

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