Nurama Developers
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.

GET
/tasks/{taskId}/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.

Authorization

AuthorizationBearer <token>

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

taskId*string
Formatuuid

Query Parameters

page?integer

Page number

Range1 <= value
Default1
limit?integer

Results per page

Range1 <= value <= 100
Default50

Response 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}