Page Comparison

...

As of Version

product version 2021 Winter | component version

Request Method GET

Response Format JSON

Description

Excerpt
Retrieves the history of the process instance specified by `processInstanceId`.

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

Query Parameter	Type	Description	Default Value
`includeIdentityLinks`	boolean	Decides whether the `identityLinks` list is included (`true`) in the individual tasks' history or not (`false`).	`false`
`includeComments`	boolean	Decides whether the `Comments` list is included (`true`) in the process history or not (`false`).	`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

Code Block

language	yml

{
  "tasks": [
    {
      "id": "00000000-0000-0000-0000-000000000000000000000123",
      "name": "My 1st_task",
      "description": "Task descriptionIn this case, you have to do several things as they are:\n1. subtask\n2. subtask",
      "assignee": "user003aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
      "owner": null,
      "createTime": "2021-11-01T12:28:46.388Z",
"user003"      "claimTime": null,
      "endTime": null,
      "identityLinks": [
        {
          "type": "assignee",
          "userId": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
          "groupId": null,
          "createTimetimestamp": "2021-11-01T0801T12:5028:2246.355Z"447Z"
        }
      ]
    }
  ],
  "comments": [
    {
      "claimTimeid": "2018-04-17T10:17:43.902+000000000001-0001-0001-0001-000000000001",
      "author": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
      "message": "This is the first example comment for the first task.",
      "endTimetime": "2021-11-01T0802T13:5005:22.355Z29.099Z",
      "processInstanceId": "00000000-0000-0000-0000-000000000000",
      "taskId": "00000000-0000-0000-0000-000000000123"
    }
  ]
}

Versions Compared

Old Version 1

New Version 2

Key