---
title: "Remove a team-defined tool (tools scope required)"
method: DELETE
path: "/api/v1/tools/{name}"
---

# Remove a team-defined tool (tools scope required)

`DELETE /api/v1/tools/{name}`

## Request

- Base URL: `https://salestick-backend-647994203646.europe-central2.run.app`
- URL: `https://salestick-backend-647994203646.europe-central2.run.app/api/v1/tools/{name}`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`

Takes effect on new calls immediately. To replace a misconfigured tool: delete, then create again, then test.

## Path parameters

- `name` string, required

## Query parameters

- `agentId` string

## Response `200`

Deleted

## Other responses

- `403`: Key lacks the tools scope
- `404`: No tool with that name

---

[API](https://skmtc.dev/canarics/apis/canarics-api-for-ai-agents.md) · [All operations](https://skmtc.dev/canarics/apis/canarics-api-for-ai-agents/llms.txt) · [OpenAPI document](https://skmtc.dev/canarics/apis/canarics-api-for-ai-agents/revisions/e89711c2f1ba?raw)