Get Identity-Link-Logs

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"
  }
]

On this Page: