Retry workflow execution

This endpoint restarts a previously failed, timed out, or terminated workflow execution by retrying tasks that did not complete successfully. It aims to resume execution activity from the point(s) of failure.

Behavior of the retry operation:

  • Targeted Task Retry: Only retries tasks that have stopped in a terminal state such as CANCELED, FAILED, FAILED_WITH_TERMINAL_ERROR, and TIMED_OUT. Optional tasks are not retried.
  • Subworkflows and Dynamic Tasks: When a failure occurs within a subworkflow or as part of a dynamic task, only the individual nested tasks that failed are retried. The subworkflow or dynamic task container itself is not retried.
  • Retry Limits: Tasks that have reached or exceeded their designated retry limits will not have their retry counts reset to zero. Instead, each retry request permits these tasks a single additional retry.
Securityoidc-token or oauth2-client-credentials or oauth2-open-industrial-data or oauth2-auth-code
Request
path Parameters
executionId
required
string (WorkflowExecutionId) = 36 characters

UUIDv4 identifier for a workflow execution.

Example: 059edaa4-a17a-4102-910e-2c3591500cce
Request Body schema: application/json
required
required
object (Authentication)
Responses
200

Updated workflow execution

404

The response for a failed request.

post/workflows/executions/{executionId}/retry
Request samples
application/json
{
  • "authentication": {
    • "nonce": "hOfy4Zop4N2SPRfl"
    }
}
Response samples
application/json
{
  • "id": "059edaa4-a17a-4102-910e-2c3591500cce",
  • "workflowExternalId": "string",
  • "version": "string",
  • "status": "RUNNING",
  • "engineExecutionId": "stringstringstringstringstringstring",
  • "createdTime": 1730204346000,
  • "startTime": 1730204346000,
  • "endTime": 1730204346000,
  • "reasonForIncompletion": "string",
  • "metadata": {
    • "property1": "string",
    • "property2": "string"
    }
}