Skip to main content
DELETE
Delete Lead Endpoint
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 real leads.

Endpoint

  • Method: DELETE
  • Path: /api/leads

Request body

string[]
required
Lead ids to delete, from GET /api/leads. Ids that are not in your workspace are ignored rather than erroring — only matching leads count toward deletedCount. An empty or missing array returns 400 No ids provided.

Behavior & Response

When the request is accepted:
  • The specified leads stop appearing in normal Tuco views for your workspace.
  • They no longer participate in future campaigns or actions.
  • List counts are updated accordingly.
Success response
If no IDs are provided you receive a 400 error. If some IDs do not belong to the workspace, they are ignored and only matching leads are counted in deletedCount. Tuco does not perform partial updates silently—either the document set for this workspace is updated as requested, or you receive a clear error explaining why nothing changed.