---
type: api
title: Delete a tool
description: **Spaces method and path for this operation:**
url: https://www.elastic.co/elastic/docs-builder/docs/4641/api/doc/kibana/v9/operation/operation-delete-agent-builder-tools-toolid
resource: https://www.elastic.co/elastic/docs-builder/docs/4641/api/doc/kibana/v9/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}`
- `DELETE` `/s/{space_id}/api/agent_builder/tools/{toolId}`

#### 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](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.
- `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
}
```