List task relations
Returns a page of "Related To" entries for a task, populated with chat / message / asset / submission / public-link context and the user who created each relation. Rows whose chat the caller cannot read are filtered out (`totalResults` reflects the filtered page). Requires read access to the task's board.
Returns a page of "Related To" entries for a task, populated with chat / message / asset / submission / public-link context and the user who created each relation. Rows whose chat the caller cannot read are filtered out (totalResults reflects the filtered page). Requires read access to the task's board.
OAuth 2.1 authorization code flow with PKCE (required of every client, public or confidential). Scopes are a ceiling on the credential, not a grant of access: a token also cannot exceed what the user who approved it may already do. A write scope does not imply its matching read — ask for both.
In: header
Scope: tasks:read
Path Parameters
uuidQuery Parameters
Page number
1 <= value1Results per page
1 <= value <= 10050Response Body
application/json
curl -X GET "https://example.com/tasks/497f6eca-6276-4993-bfeb-53cbbbba6f08/relations"{ "page": 0, "limit": 0, "totalPages": 0, "totalResults": 0, "queryAt": 0, "results": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "taskId": "e6e9d88a-9b63-468a-aec3-b7a11de27af8", "resourceId": "026d60bb-63a8-407e-bf67-01dcfc6022e6", "resourceType": "chat", "creatorId": "688ebf54-d343-4104-8711-82c2feac534a", "createdAt": 0, "updatedAt": 0, "relatedBy": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "firstName": "string", "lastName": "string", "displayName": "string", "avatar": "01d8bd6c-6014-46aa-b5b1-14d337c9c779", "color": "string", "awards": [ "staff" ], "accountType": "standard" }, "chat": {}, "asset": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "name": "string", "mediaType": "string", "files": [ {} ] }, "submission": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "subject": "string" }, "publicLink": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "name": "string" }, "message": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "chatId": "f255124e-3419-4f6e-b7ee-17a6577db94d", "content": "string", "authorId": "ee6f7132-bd0a-4fcd-83b3-a8022377067b", "author": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "firstName": "string", "lastName": "string", "displayName": "string", "avatar": "01d8bd6c-6014-46aa-b5b1-14d337c9c779", "color": "string", "awards": [ "staff" ], "accountType": "standard" }, "mentions": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "firstName": "string", "lastName": "string", "displayName": "string", "avatar": "01d8bd6c-6014-46aa-b5b1-14d337c9c779", "color": "string", "awards": [ "staff" ], "accountType": "standard" } ], "assetMentions": [ {} ], "folderMentions": [ {} ], "createdAt": 0 } } ], "hasNextPage": true, "hasPrevPage": true}