# DELETE /api/leads/{id}

> Leads - Delete a Lead

- **Endpoint:** `DELETE /api/leads/{id}`
- **Group:** Leads
- **Since:** v1.0.0
- **Defined in:** `RestApi/Controllers/LeadsController.php`

## Headers

| Field | Type | Description |
| --- | --- | --- |
| `authtoken` | String | Authentication token, generated from admin area |

## Parameters

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | Number | yes | lead unique ID. |

## Request example

```bash
curl -X DELETE "https://yoursite.com/index.php/api/leads/123" \
  -H "authtoken: YOUR_API_TOKEN"
```

## Responses

### Success - Success-Response:

```json
HTTP/1.1 200 OK
{
  "status": true,
  "message": "Lead Deleted Successfully."
}


HTTP/1.1 404 Not Found
{
  "status": false,
  "message": "Lead Delete Fail."
}
```

---

Part of the [REST API for RISE CRM](https://risecrm.themesic.com/apiguide/) documentation.
Full page: https://risecrm.themesic.com/apiguide/leads/delete-lead/