Restart Workflow
Endpoint: POST /api/workflow/{workflowId}/restart
Restarts a terminal workflow execution from the beginning using the same input and workflow definition, with the option to use the latest definition instead. This method has no effect on ongoing workflows.
Path parameters
| Parameter | Description | Type | Required/ Optional |
|---|---|---|---|
| workflowId | The execution ID of the workflow to be restarted. | string | Required. |
Query parameters
| Parameter | Description | Type | Required/ Optional |
|---|---|---|---|
| useLatestDefinitions | If set to true, the restarted workflow will use the latest definition from the metadata store. Default is false. | boolean | Optional. |
Examples
Restart workflow execution without using the latest definition
Request
curl -X 'POST' \
'https://<YOUR_CLUSTER>/api/workflow/bf6ac066-d493-11ef-87b1-b2b27c52ebde/restart' \
-H 'accept: */*' \
-H 'X-Authorization: <TOKEN>' \
-d ''
Response
Returns 204, indicating that the workflow execution has been restarted successfully.
Restart workflow execution using the latest definition
Request
curl -X 'POST' \
'https://<YOUR_CLUSTER>/api/workflow/bf6ac066-d493-11ef-87b1-b2b27c52ebde/restart?useLatestDefinitions=true' \
-H 'accept: */*' \
-H 'X-Authorization: <TOKEN>' \
-d ''
Response
Returns 204 No Content, indicating that the workflow execution has been restarted successfully.