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

> ## Agent Instructions
> Collabase documentation. Interface labels are quoted in English, as they appear in the product.
> Features marked Enterprise need the Collabase Enterprise Edition licence.

# Delete CRM list

> Delete a list; the records on it stay.

Deletes a list. The records on it are not touched.

> [!NOTE]
>
> Scope `crm:write`. Only the owner of a list deletes it, or a person with the right to delete lists.

## Path parameters

**id** `string` *required*

The list.

## Response

**success** `boolean` *required*

`true` once it is deleted.

```bash cURL theme={"dark"}
curl -X DELETE "https://your-collabase.ch/api/v1/crm/lists/cm3list001" \
  -H "Authorization: Bearer cb_xYz123ABCD..."
```

```json 200 theme={"dark"}
{ "data": { "success": true } }
```

```json 404 theme={"dark"}
{ "error": { "code": "NOT_FOUND", "message": "List not found" } }
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.