Skip to main content
PUT
/
external-task
/
retries
Set Retries Sync
curl --request PUT \
  --url http://{host}:{port}/{contextPath}/external-task/retries \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '{
  "retries": 123,
  "externalTaskIds": [
    "anExternalTask",
    "anotherExternalTask"
  ]
}'
This response does not have an example.

Authorizations

​
Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Body

application/json
​
retries
integer | null

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
string[] | null

The ids of the external tasks to set the number of retries for.

​
processInstanceIds
string[] | null

The ids of process instances containing the tasks to set the number of retries for.

​
externalTaskQuery
object

A JSON object with the following properties:

​
processInstanceQuery
object

A process instance query which defines a group of process instances

​
historicProcessInstanceQuery
object

A historic process instance query which defines a group of historic process instances

Response

Request successful.