Skip to main content
DELETE
Delete API Tool
The Try it panel runs against production (https://app.tuco.ai) with the key you paste into it. There is no sandbox — a request from this page permanently deletes a real tool.
An API tool lets a goal bot call your endpoint mid-conversation — check stock, look up an order, fetch a balance — and use the answer in its reply. Attach a tool to a bot by putting its _id in that bot’s allowedToolIds.
The tool id goes in the query string, not the body — ?id=.... There is no request body, and a DELETE without id returns 400 Invalid tool id.

Authentication

Pass your workspace API key as a Bearer token, or use a Clerk session token.

Query parameter

string
required
The tool _id from GET /api/campaign-tools. A missing or malformed id returns 400 Invalid tool id.

Example

Success (200 OK)

Deleting a tool does not edit the bots that referenced it — a stale id left in a bot’s allowedToolIds is simply ignored. Clean it up with PATCH /api/goal-bots/{id} if you want the config tidy.

Errors