Get mentionable board tasks for a chat with pagination

Returns a paginated list of board tasks that can be mentioned in the specified chat. Requires the workspace to have the `boards` capability. Scope/visibility rules: - **Topic chat about a project**: Tasks in that project on boards whose `visibility` array includes the chat's visibility. - **Topic chat about an asset**: Tasks in the asset's owner project on boards whose `visibility` array includes the chat's visibility. - **Topic chat about a task**: Sibling tasks in the parent task's project on boards whose `visibility` array includes the chat's visibility. - **Member chat with project scope**: All board tasks in that project (no visibility filter — mirrors asset/folder mention behaviour for this chat type). - **Submission chat**: Tasks in the submission's project on boards whose `visibility` array includes `'reviewer'`. - **Member chat with workspace/social scope**: Empty result — no tasks are mentionable. Legacy mention-only tasks (`boardId === null`) are never returned. The `nameSearch` query is OR-matched across `subject` substring, exact `taskNumber` (when numeric), and exact `id` (when a UUID). Returns `capabilityNotAvailable` / 403 when the workspace lacks the `boards` capability.

Returns a paginated list of board tasks that can be mentioned in the specified chat. Requires the workspace to have the boards capability.

Scope/visibility rules:

Topic chat about a project: Tasks in that project on boards whose visibility array includes the chat's visibility.
Topic chat about an asset: Tasks in the asset's owner project on boards whose visibility array includes the chat's visibility.
Topic chat about a task: Sibling tasks in the parent task's project on boards whose visibility array includes the chat's visibility.
Member chat with project scope: All board tasks in that project (no visibility filter — mirrors asset/folder mention behaviour for this chat type).
Submission chat: Tasks in the submission's project on boards whose visibility array includes 'reviewer'.
Member chat with workspace/social scope: Empty result — no tasks are mentionable.

Legacy mention-only tasks (boardId === null) are never returned. The nameSearch query is OR-matched across subject substring, exact taskNumber (when numeric), and exact id (when a UUID).

Returns capabilityNotAvailable / 403 when the workspace lacks the boards capability.

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Path Parameters

chatId*string

The unique identifier of the chat

Formatuuid

Query Parameters

nameSearch?string

Optional search filter — matches subject substring (case-insensitive), exact taskNumber, or exact task id

sort?

Sort order (1 for ascending, -1 for descending). Defaults to most recently updated first.

Default

{  "updatedAt": -1}

limit?number

Maximum number of results per page

Rangevalue <= 100

Default20

paginate?string

Pagination type (cursor or index-based)

Default"index"

Value in

"cursor"
"index"

cursor?string

Cursor for cursor-based pagination (only when paginate=cursor)

paginateReverse?boolean

Reverse pagination direction (only when paginate=cursor)

includeCounts?boolean

Include total counts (only when paginate=cursor)

includeCursorRecord?boolean

Include cursor record (only when paginate=cursor)

page?number

Page number (only when paginate=index)

Response Body

`application/json`

curl -X GET "https://example.com/chats/497f6eca-6276-4993-bfeb-53cbbbba6f08/mentionable/tasks"

{  "results": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "subject": "string",      "taskNumber": 0,      "status": "pending",      "projectId": "5a8591dd-4039-49df-9202-96385ba3eff8",      "boardId": "a654038e-9287-48a2-acfd-90b8cfa8b1f4",      "assignedToId": "7a15e53b-1403-4928-9451-d7062c3a8737",      "createdAt": 0,      "updatedAt": 0    }  ],  "page": 0,  "limit": 0,  "totalResults": 0,  "totalPages": 0,  "hasNext": true,  "hasPrev": true}