Skip to main content
DELETE
Delete Lead List
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 list.
A list owns leads. listId is what you pass to POST /api/leads to file new leads somewhere specific, and to POST /api/leads/check-availability to check a whole list at once. These endpoints are how you get a listId without opening the dashboard.
The list id goes in the request body, not the URL. DELETE /api/lists with no body returns 400 List ID is required. Some HTTP clients drop bodies on DELETE by default — if you get that error with an id you know is correct, that is why.

Authentication

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

Request body

string
required
The list to delete, from GET /api/lists.
boolean
default:"false"
What happens to the leads inside it.
deleteLeads: true is permanent and takes the conversation history with it.

Example

Success (200 OK)

With deleteLeads: true, deletedLeads reads "all leads deleted".

Errors