Clean up history (POST)

Schedules asynchronous history cleanup (See History cleanup).

Method

POST /history/cleanup

Parameters

Query Parameters

Name Description
immediatelyDue When true the job will be scheduled for nearest future. When false, the job will be scheduled for next batch window start time. Default is true.

Request Body

Not used

Result

Result is not reliable any more

Be aware, that since v. 7.9.0, the correct response object is not guaranteed any more. Use GET /history/cleanup/jobs to find history cleanup jobs.

A JSON object representing scheduled job. See Get Job for the structure and example.

Response Codes

Code Media type Description
200 application/json Request successful.
400 application/json Returned if some of the query parameters are invalid or the engine does not participate in history cleanup. See Cleanup Execution Participation per Node.

Example

Request

POST /history/cleanup?immediatelyDue=false

Response

{
    "id":"074bd92a-1a95-11e7-8ceb-34f39ab71d4e",
    "jobDefinitionId":null,
    "processInstanceId":null,
    "processDefinitionId":null,
    "processDefinitionKey":null,
    "executionId":null,
    "exceptionMessage":null,
    "retries":3,
    "dueDate":"2017-04-06T13:57:45.000+0200",
    "suspended":false,
    "priority":0,
    "tenantId":null,
    "createTime": "2017-04-01T09:45:15.039+0100"

}

On this Page: