# Tools: Delete a tool (https://docs.envocal.ai/api-reference/tools/delete-a-tool/) > Not possible while an agent uses the tool: take it out of the agents' tool assignments first. ## DELETE `/v1/tenants/{tenantId}/tools/{id}` Not possible while an agent uses the tool: take it out of the agents' tool assignments first. **Required permission:** `tools:write` ### Parameters | Name | In | | Type | Description | | --- | --- | --- | --- | --- | | `tenantId` | path | required | string | Tenant id, or `current` for the key's own tenant. Must be the key's tenant or one of its sub-tenants. | | `id` | path | required | string (uuid) | Tool id. | ### Responses **204**: Deleted. **401**: Missing, invalid, revoked or expired API key. **403**: The key lacks the required permission, or the tenant/resource is outside its reach. **404**: Not found in this tenant. **409**: Still used by agents (`agentToolCount` says how many assignments). **429**: Rate limit exceeded. Retry after the number of seconds in the Retry-After header. ### Example ```bash curl -X DELETE "https://api.envocal.ai/v1/tenants/current/tools/{id}" \ -H "Authorization: Bearer evk_eu_..." ```