Queries for historic identity link logs that fulfill given parameters. The size of the result set can be retrieved by using the Get Identity-Link-Log Count method.

Method

GET /history/identity-link-log

Parameters

Query Parameters

Name	Description
type	Restricts to identity links that have the given type (candidate/assignee/owner).
userId	Restricts to identity links that have the given user id.
groupId	Restricts to identity links that have the given group id.
dateBefore	Restricts to identity links that have the time before the given time.
dateAfter	Restricts to identity links that have the time after the given time.
taskId	Restricts to identity links that have the given task id.
processDefinitionId	Restricts to identity links that have the given process definition id.
processDefinitionKey	Restricts to identity links that have the given process definition key.
operationType	Restricts to identity links that have the given operationType (add/delete).
assignerId	Restricts to identity links that have the given assigner id.
tenantIdIn	Filter by a comma-separated list of tenant ids.
withoutTenantId	Only include historic identity links that belong to no tenant. Value may only be true, as false is the default behavior.
sortBy	Sort the results lexicographically by a given criterion. Valid values are time, type, userId, groupId, taskId, processDefinitionId, processDefinitionKey, operationType, assignerId and tenantId. Must be used in conjunction with the sortOrder parameter.
sortOrder	Sort the results in a given order. Values may be asc for ascending order or desc for descending order. Must be used in conjunction with the sortBy parameter.
firstResult	Pagination of results. Specifies the index of the first result to return.
maxResults	Pagination of results. Specifies the maximum number of results to return. Will return less results if there are no more results left.

Result

A JSON array of historic identity link log objects. Each historic identity link log object has the following properties:

Name	Type	Description
id	String	Id of the Historic identity link entry.
time	String	The time when the identity link is logged. Default format* yyyy-MM-dd'T'HH:mm:ss.SSSZ.
type	String	The type of identity link (candidate/assignee/owner).
userId	String	The id of the user/assignee.
groupId	String	The id of the group.
taskId	String	The id of the task.
processDefinitionId	String	The id of the process definition.
processDefinitionKey	String	The key of the process definition.
operationType	String	Type of operation (add/delete).
assignerId	String	The id of the assigner.
tenantId	String	The id of the tenant.
removalTime	String	The time after which the identity link should be removed by the History Cleanup job. Default format* yyyy-MM-dd'T'HH:mm:ss.SSSZ.
rootProcessInstanceId	String	The process instance id of the root process instance that initiated the process containing this identity link.

* For further information, please see the documentation.

Response Codes

Code	Media type	Description
200	application/json	Request successful.
400	application/json	Returned if some of the query parameters are invalid, for example if a sortOrder parameter is supplied, but no sortBy. See the Introduction for the error response format.

Example

Request

GET /history/identity-link-log?taskId=aTaskId

Response

[
  {
    "id": "1",
    "time": "2014-03-01T08:00:00.000+0200",
    "type": "candidate",
    "userId": "aUserId",
    "groupId": "aGroupId",
    "taskId": "aTaskId",
    "processDefinitionId": "12",
    "operationType": "add",
    "assignerId": "aAssignerId",
    "processDefinitionKey": "oneTaskProcess",
    "tenantId": "tenant1",
    "removalTime":"2018-02-10T14:33:19.000+0200",
    "rootProcessInstanceId": "aRootProcessInstanceId"
  },
  {
    "id": "2",
    "time": "2014-03-05T10:00:00.000+0200",
    "type": "candidate",
    "userId": "aUserId",
    "groupId": "aGroupId",
    "taskId": "aTaskId",
    "processDefinitionId": "12",
    "operationType": "delete",
    "assignerId": "aAssignerId"
    "processDefinitionKey": "oneTaskProcess",
    "tenantId": "tenant1",
    "removalTime":"2018-02-10T14:33:19.000+0200",
    "rootProcessInstanceId": "aRootProcessInstanceId"
  }
]