---
title: "Delete a tool"
method: DELETE
path: "/v1/tools/{id}"
tags: ["tools"]
---

# Delete a tool

`DELETE /v1/tools/{id}`

## Request

- Base URL: `https://api.pomerado.ai`
- URL: `https://api.pomerado.ai/v1/tools/{id}`
- Auth: HTTP bearer

Delete one tool permanently, public or private.

- A Business Owner or Admin, or a Personal account's owner, can delete any tool their team created. Anyone else can delete only tools they created; others answer forbidden.
- The tool leaves every list and stops running, including runs already started.
- The rest of its integration stays. An integration left with no tools is removed too, with its MCP and everything bound to it.
- This can't be undone.

## Path parameters

- `id` string, required

## Response `204`

Deleted

## Other responses

- `400`: invalid_request
- `401`: unauthorized, reauthentication_required
- `403`: forbidden
- `404`: not_found
- `500`: internal_error
- `503`: temporarily_unavailable

---

[API](https://skmtc.dev/pomerado/apis/pomerado-api.md) · [All operations](https://skmtc.dev/pomerado/apis/pomerado-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pomerado/apis/pomerado-api/revisions/c07cea59691c?raw)