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

# Delete lead

> Permanently delete a lead from a campaign.

Permanently deletes a lead from the system.

## Endpoint

`DELETE /user/leads/{id}`

## Path parameters

<ParamField path="id" type="integer" required>
  ID of the lead to delete.
</ParamField>

## Response

<ResponseField name="message" type="string">
  Confirmation that the lead was deleted.
</ResponseField>

## Example

<CodeGroup>
  ```bash cURL theme={null}
  curl -X DELETE "https://portal.intellixent.ai/api/user/leads/123" \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```

  ```javascript Node.js theme={null}
  const response = await fetch('https://portal.intellixent.ai/api/user/leads/123', {
    method: 'DELETE',
    headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
  });

  const data = await response.json();
  console.log(data.message);
  ```
</CodeGroup>

```json 200 Success theme={null}
{
  "message": "Lead deleted successfully"
}
```

```json 404 Not found theme={null}
{
  "message": "Lead not found"
}
```

<Warning>
  Deletion is permanent. The lead and its associated call history are removed and cannot be recovered.
</Warning>