REST API - purgeTerminatedProcessInstances

The table summarizes the REST API - purgeTerminatedProcessInstances.

Request

Format
DELETE <baseurl>/process/purge/terminated/instances
Query parameters
  • name=string (0..n): Name of the process template for which instances are to be purged.
  • states=string (0..n): purge those process instances with specified state(s). If no state(s) are specified, then process instances that are in a terminal state will be purged..
  • applications=string (0..n): the applications for which all the process instances in the contained process templates are to be purged.
  • instances=string(0..n): the process instances to be purged.
  • thresholddate=string (0..n): Date before which process instances must have been completed, cancelled or failed for them to be purged in this operation.
  • batchsize=int batchSize: Number of process instances that should be deleted before the transaction is committed.
  • runinbackground=Boolean value specifying whether the purge runs in the background. If:
    • True: The purge will run in the background and the operation returns immediately. This is the default value.
    • False: The operation waits for the purge to complete before returning (subject to timeouts).

      These parameters can be obtained from queryProcessTemplates and queryProcessTemplatesAlt.

Response

JSON If successful, returns 200 OK in the response header, and Status Message as shown in the example in the response body.
XML If successful, returns 200 OK in the response header, and Status Message as shown in the example in the response body.

Example

Request
GET <baseurl>/process/purge/terminated/instances?states=COMPLETED&thresholddate=P2Y4M5DT10H12M15S
Response
{
    "xml-fragment": {
        "statusMessage": "",
        "totalInstanceCount": 0,
        "status": "PURGE_IN_PROGRESS"
    }
}