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

# Delete Lead List

> Permanently deletes a lead list

Permanently deletes a lead list by its unique identifier. This action cannot be undone.

## Authentication

This endpoint requires authentication. Only users with access to the lead list (or admin users) can delete it.

<Warning>
  This operation is irreversible. The lead list and its associations will be
  permanently removed. The underlying persons or companies are not deleted.
</Warning>

## Request

<ParamField path="id" type="string (UUID)" required>
  The unique identifier of the lead list to delete.
</ParamField>

## Response

Returns an empty response with status code `204 No Content` on successful deletion.

<ResponseField name="(empty)" type="void">
  No response body is returned on successful deletion.
</ResponseField>

## Response Examples

<ResponseExample>
  ```json 204 theme={null}
  (No content)
  ```

  ```json 403 theme={null}
  {
    "error": {
      "code": "FORBIDDEN",
      "message": "You do not have access to this lead list"
    }
  }
  ```

  ```json 404 theme={null}
  {
    "error": {
      "code": "NOT_FOUND",
      "message": "LeadList with id 'invalid-id' not found"
    }
  }
  ```
</ResponseExample>

## Error Codes

| Status Code | Error Code       | Description                                                                                         |
| ----------- | ---------------- | --------------------------------------------------------------------------------------------------- |
| 403         | `FORBIDDEN`      | User does not have access to this lead list. Only users in `userIds` or admins can delete the list. |
| 404         | `NOT_FOUND`      | No lead list exists with the specified ID.                                                          |
| 500         | `INTERNAL_ERROR` | An unexpected server error occurred.                                                                |

## Authorization Rules

* **Access Control**: Only users whose ID is in the `userIds` array can delete the lead list.
* **Admin Override**: Users with the admin role can delete any lead list regardless of `userIds`.

## Notes

* Deleting a lead list does **not** delete the associated persons or companies. Only the list itself and its ID associations are removed.
* If you need to archive a list instead of permanently deleting it, consider implementing a soft-delete mechanism or moving the list to an archive state.