Update history time to live

Updates history time to live for process definition. The field is used within History cleanup.

Method

PUT /process-definition/{id}/history-time-to-live

PUT /process-definition/key/{key}/history-time-to-live (updates the latest version of the process definition which belongs to no tenant)

PUT /process-definition/key/{key}/tenant-id/{tenant-id}/history-time-to-live (updates the latest version of the process definition for tenant)

Parameters

Path Parameters

Name Description
id The id of the process definition to change history time to live.
key The key of the process definitions to change history time to live.
tenant-id The id of the tenant the process definitions belong to.

Request Body

A JSON object with the following properties:

Name Description
historyTimeToLive New value for historyTimeToLive field of process definition. Can be null. Can not be negative.

Result

This method returns no content.

Response Codes

Code Media type Description
204 Request successful.
400 application/json Returned if some of the request parameters are invalid.
404 application/json Process definition with given id does not exist. See the Introduction for the error response format.

Example

Request

PUT /process-definition/aProcessDefinitionId/history-time-to-live

    {
      "historyTimeToLive" : 5
    }

Response

Status 204. No content.

On this Page: