---
title: "Delete tool"
method: DELETE
path: "/v2/tools/{tool_id}"
tags: ["Tools"]
---

# Delete tool

`DELETE /v2/tools/{tool_id}`

Deletes a tool and its configuration permanently. This action cannot be undone. Agent calls to a deleted tool fail. Update agent configurations before you delete a tool.

## Path parameters

- `tool_id` string, required

## Headers

- `Request-Timeout` integer
- `Request-Timeout-Millis` integer

## Response `204`

The tool is deleted.

## Other responses

- `403` — Permissions do not allow deleting this tool.
- `404` — Tool not found.

---

[API](https://skmtc.net/vectara/apis/vectara-rest-api-v2.md) · [All operations](https://skmtc.net/vectara/apis/vectara-rest-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vectara/vectara-rest-api-v2/versions/fca567a46b3a/schema)