Skip to main content
DELETE
Delete Task Agent
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 agent.
This is an alias. DELETE /api/tasks/{id} and DELETE /api/goal-bots/{id} are the same route.
Deletes the agent permanently. Conversations it already handled are untouched. There is no body.
The built-in Auto Replies agent cannot be deleted — it is recreated on the next list call. Deleting it returns 409. Set its mode to manual to stop it instead.

Authentication

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

Path parameter

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

Example

Success (200 OK)


Errors