GET /bpm-engine/api/processes/{processInstanceId}/history

As of Version

product version 2021 Winter | component version

Request Method GET

Response Format JSON

Description

Retrieves the history of the process instance specified by processInstanceId.

Optionally, the boolean query parameter includeProcessVariables can be added to the request URL in order to include process variables in the result. Default is false.

Meaning of HTTP status codes:

HTTP Status Code	Description
200	The process instance history was found and returned.
400	Bad Request.
403	Forbidden.
404	The requested process instance specified by `processInstanceId` was not found.
409	Conflict.
415	Unsupported Media Type.
500	Internal Server Error.

Each error is thrown in the response body in JSON format containing an error message and an exception string.

Request Header Content-Type: application/json

Request Example

https://<host>/bpm-engine/api/processes/00000000-0000-0000-0000-000000000000/history

Response Example

{
  "tasks": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "name": "My task",
      "description": "Task description",
      "assignee": "user003",
      "owner": "user003",
      "createTime": "2021-11-01T08:50:22.355Z",
      "claimTime": "2018-04-17T10:17:43.902+0000",
      "endTime": "2021-11-01T08:50:22.355Z"
    }
  ]
}