Get Identity Links
Gets the identity links for a task by id, which are the users and groups that are in some relation to it (including assignee and owner).
Method
GET /task/{id}/identity-links
Parameters
Path Parameters
Name | Description |
---|---|
id | The id of the task to retrieve the identity links for. |
Query Parameters
Name | Description |
---|---|
type | Filter by the type of links to include. |
Result
A JSON object containing the a list of identity links.
Name | Value | Description |
---|---|---|
userId | String | The id of the user participating in this link. |
groupId | String | The id of the group participating in this link. Either groupId or userId is set. |
type | String | The type of the identity link. Can be any defined type. assignee and owner are reserved types for the task assignee and owner. |
Response Codes
Code | Media type | Description |
---|---|---|
200 | application/json | Request successful. |
400 | application/json | Task with given id does not exist. See the Introduction for the error response format. |
Example
Request
GET /task/anId/identityLinks
Response
[{
"userId": "userId",
"groupId": null,
"type": "assignee"
},
{
"userId": null,
"groupId": "groupId1",
"type": "candidate"
},
{
"userId": null,
"groupId": "groupId2",
"type": "candidate"
}]