Skip to main content
DELETE
/
api
/
leads
Delete Lead Endpoint
curl --request DELETE \
  --url https://api.example.com/api/leads

​
Endpoint

  • Method: DELETE
  • Path: /api/leads

​
Request Body

{
  "ids": [
    "667f1f77bcf86cd799439012",
    "667f1f77bcf86cd799439013"
  ]
}
  • ids – array of lead IDs to delete in the active workspace.

​
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 
{
  "deletedCount": 2
}
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.