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

> Change the title, description, due date, status, assignees or records of a task.

Changes a task. Send only what changes.

> [!NOTE]
>
> Scope `crm:write`. The token owner needs the right to change the task.

## Path parameters

**id** `string` *required*

The task.

## Request body

**title** `string`

Up to 200 characters.

**description** `string | null`

Plain text; `null` clears it.

**dueDate** `string | null`

A calendar day, `YYYY-MM-DD`; `null` clears it.

**status** `string`

`TODO`, `IN_PROGRESS` or `DONE`.

**assigneeIds** `array`

The people on the task; new ones are told as in the app.

**targetIds** `array`

The records the task is on, 1 to 20.

**baseUpdatedAt** `string`

The `updatedAt` you read; a task changed since answers `409`.

## Response

The task as it is now.

```bash cURL theme={"dark"}
curl -X PATCH "https://your-collabase.ch/api/v1/crm/tasks/cm3task001" \
  -H "Authorization: Bearer cb_xYz123ABCD..." \
  -H "Content-Type: application/json" \
  -d '{ "status": "DONE" }'
```

```json 200 theme={"dark"}
{ "data": { "id": "cm3task001", "status": "DONE" } }
```

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


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