Skip to main content
DELETE
Delete Goal Bot
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 bot.
Goal bots and task agents are the same object. The two engines merged; /api/goal-bots and /api/tasks are aliases over one collection and return identical bodies. Every response carries both goalBot and taskAgent (or goalBots and taskAgents) so integrations written against either name keep working.The older stage-based engine moved to /api/instructions and is being retired.
Deletes the bot permanently. Conversations it already handled are untouched — only the bot is removed. There is no body.
The built-in Auto Replies bot cannot be deleted. It is recreated on the next list call, so a successful delete would be a lie. Deleting it returns 409; set its mode to manual to stop it instead.
To stop a bot temporarily, PATCH status to "paused" rather than deleting it.

Authentication

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

Path parameter

string
required
The bot id. A malformed id returns 400 Invalid id.

Example

Success (200 OK)


Errors