Task Relations
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.
Authorization
bearerAuth AuthorizationBearer <token>
In: header
Path Parameters
taskId*string
Format
uuidQuery Parameters
page?integer
Page number
Range
1 <= valueDefault
1limit?integer
Results per page
Range
1 <= value <= 100Default
50Response 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}