Set Retries For Multiple External Tasks Sync

Sets the number of retries left to execute external tasks by id synchronously. If retries are set to 0, an incident is created.

Method

PUT /external-task/retries

A JSON object with the following properties:

Name	Description
retries	The number of retries to set for the external task. Must be >= 0. If this is 0, an incident is created and the task cannot be fetched anymore unless the retries are increased again. Can not be null.
externalTaskIds	The ids of the external tasks to set the number of retries for.
processInstanceIds	The ids of process instances containing the tasks to set the number of retries for.
externalTaskQuery	Query for the external tasks to set the number of retries for.
processInstanceQuery	Query for the process instances containing the tasks to set the number of retries for.
historicProcessInstanceQuery	Query for the historic process instances containing the tasks to set the number of retries for.

This method returns no content.

Code	Media type	Description
204		Request successful.
400	application/json	In case the number of retries is negative or null, an exception of type `InvalidRequestException` is returned. See the Introduction for the error response format.
404	application/json	Returned if the task does not exist. This could indicate a wrong task id as well as a cancelled task, e.g., due to a caught BPMN boundary event. See the Introduction for the error response format.

PUT /external-task/retries

Request Body:

    {
      "retries": 123,
      "externalTaskIds": [
        "anExternalTask",
        "anotherExternalTask"
      ]
    }

Status 204. No content.