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

# Delete List

## `DELETE` a List

`DELETE` `/user-api/v1/lists/:id`

### Path Parameters

<ParamField path="id" type="string">
  List ID
</ParamField>

### Query Parameters

<ParamField path="include" type="string">
  Related data to include: `contacts`, `companies`
</ParamField>

### Endpoint Example

`DELETE` `/user-api/v1/lists/list_99999?include=contacts`

### Response

```json theme={null}
{
  "data": {
    "id": "list_99999",
    "name": "Premium VIP Contacts",
    "type": "CONTACT",
    "description": "Updated description for our premium contacts",
    "created_at": "2025-01-15T10:30:00Z",
    "updated_at": "2025-01-15T12:45:00Z",
    "contacts": [
      {
        "id": "contact_123",
        "full_name": "John Doe",
        "image_url": "https://example.com/avatar.jpg"
      },
      {
        "id": "contact_999",
        "full_name": "Alice Wilson",
        "image_url": "https://example.com/avatar4.jpg"
      }
    ]
  }
}
```