> ## 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.

# Update CRM list

> Rename a list or change its query, visibility or group.

Changes a list. Send only what changes.

> [!NOTE]
>
> Scope `crm:write`. Only the owner of a list changes it.

## Path parameters

**id** `string` *required*

The list.

## Request body

**name** `string`

The new name.

**cql** `string`

The query of a dynamic list.

**visibility** `string`

`PRIVATE` or `SHARED`.

**groupId** `string | null`

The group the list sits in; `null` takes it out.

## Response

The list as it is now.

```bash cURL theme={"dark"}
curl -X PATCH "https://your-collabase.ch/api/v1/crm/lists/cm3list001" \
  -H "Authorization: Bearer cb_xYz123ABCD..." \
  -H "Content-Type: application/json" \
  -d '{ "name": "Christmas gifts 2026" }'
```

```json 200 theme={"dark"}
{ "data": { "id": "cm3list001", "name": "Christmas gifts 2026" } }
```

```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.