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

> Change the fields, contact points, relations, owner or title of a record against the version you read.

Changes a record. Send only what changes. A request that changes nothing writes nothing and leaves the version as it is.

> [!NOTE]
>
> Scope `crm:write`. The token owner needs the right to change the type and may write only the fields their roles allow.

## Path parameters

**id** `string` *required*

The record.

## Request body

**baseUpdatedAt** `string` *required*

The `contentUpdatedAt` you read, as an ISO 8601 instant in UTC. A newer version answers `409 CRM_CONFLICT_VERSION` with the record in `error.current`.

**title** `string`

Renames a record that is named by its title. Ignored for a person.

**fields** `object`

Values by short field key; `null` clears a field. A required field cannot be cleared.

**contactPoints** `array`

The whole set of the kinds the token owner may write. A kind you leave out is cleared; a kind they may not write must not appear.

**links** `array`

Replaces the targets of each relation kind it names.

**clearLinkKeys** `array`

Relation kinds to empty, such as `["person_company"]`.

**ownerId** `string | null`

An active internal person, or `null` for no owner.

## Response

The record as it is now, as in [Get CRM record](https://collabase.ch/docs/api/crm/get-record.md).

```bash cURL theme={"dark"}
curl -X PATCH "https://your-collabase.ch/api/v1/crm/records/cm3rec0001" \
  -H "Authorization: Bearer cb_xYz123ABCD..." \
  -H "Content-Type: application/json" \
  -d '{
    "baseUpdatedAt": "2026-11-02T09:30:00.000Z",
    "fields": { "annualRevenue": 1500000 }
  }'
```

```json 200 theme={"dark"}
{ "data": { "id": "cm3rec0001", "typeKey": "company", "title": "Beispiel AG", "contentUpdatedAt": "2026-11-02T10:12:00.000Z" } }
```

```json 409 theme={"dark"}
{ "error": { "code": "CRM_CONFLICT_VERSION", "message": "The record was changed by someone else since it was loaded.", "current": { "id": "cm3rec0001" } } }
```


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