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

# List CRM tasks

> List the CRM tasks of one record, or the tasks assigned to the token owner, soonest due first.

Returns tasks that belong to the CRM and are visible to the token owner. A task is visible when at
least one of its records is; a record in the trash hides its tasks.

> [!NOTE]
>
> Scope `crm:read`.

## Query parameters

**scope** `string` *required*

`record` for the tasks of one record, `mine` for the tasks assigned to the token owner.

**recordId** `string`

Required with `scope=record`.

**status** `string` (default: all)

`open` for tasks that are not done, or `all`.

**cursor** `string`

The `nextCursor` of the previous page.

**limit** `number` (default: 25)

1 to 100; more is cut down to 100.

## Response

**data** `object` *required*

**properties**

**items** `array` *required*

Each task has `id`, `title`, `description`, `status` (`TODO`, `IN_PROGRESS`, `DONE`), `dueDate` (`YYYY-MM-DD`), `assignees`, `targets`, `createdAt` and `updatedAt`.

**nextCursor** `string | null` *required*

`null` on the last page.

**canCreate** `boolean` *required*

Whether the token owner may create tasks.

```bash cURL theme={"dark"}
curl "https://your-collabase.ch/api/v1/crm/tasks?scope=mine&status=open" \
  -H "Authorization: Bearer cb_xYz123ABCD..."
```

```json 200 theme={"dark"}
{ "data": { "items": [], "nextCursor": null, "canCreate": true } }
```


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