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"

}

Options