> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tuco.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete Lead Endpoint

> Delete one or more leads from a Tuco workspace

## Endpoint

* **Method**: `DELETE`
* **Path**: `/api/leads`

***

## Request Body

```json theme={null}
{
  "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**

```json theme={null}
{
  "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.