Run a failed run again after you fix it
Retry a failed run once your fix is published, and know what to do when a run cannot be retried.
When a run fails, you do not have to wait for the trigger to fire again. Fix the cause, then retry the failed run. The retry sends the same trigger data through your workflow as a new run. The failed run stays as it was, as a record of what happened.
The full steps are in Retry a failed run. This page is the short version.
Fix first, then retry
Find out why the run failed
Open the run and read the error on the step that failed. See Read a failed run.
Fix the cause
If the workflow was wrong, fix it and publish. A retry runs on your newest published version, so an unpublished change does not count. If a connection stopped working, reconnect it. If the other service had a temporary problem, wait until it is back.
Retry the run
At the top of the failed run's page, click Retry from failed step. The steps that already worked keep their results, and the new run starts at the step that failed.
To retry several failed runs at once, set the Status filter on the runs list to Failed, tick the runs, and click Retry selected. See Retry several runs at once.
What to expect
- The retry is a new run. It carries a Retry of badge, and the failed run carries a Retried as badge. Each badge opens the other run.
- The button may read Run again. If you changed a step that comes before the failed step, the run cannot pick up where it stopped. It runs from the start with the original trigger data, and the steps that already worked run again.
- A failure inside a loop or a parallel step restarts the whole block. Every item or branch runs again, including the ones that worked.
- Only failed runs can be retried. A completed run, a cancelled run, and a run stopped by a rejected approval have no retry.
- A run can be retried once. If the retry fails too, retry the retry.
If you cannot retry
| What you see | What to do |
|---|---|
| No retry button | Check that the run's status is failed. Other runs cannot be retried. |
| "Turn the workflow back on to retry" | Publish or switch on a version of the workflow, then retry. |
| "Resume the workflow to retry" | The workflow is paused for safety. See Why a run paused. |
| "Retry the run that started it" | Another run started this one. Retry that run instead. |
| "Too many retries in this workspace. Try again in a minute." | Wait a minute, then retry. |
If a run cannot be retried at all, start a new run. Open the workflow and click Run, or wait for the next trigger event.
Related
- Retry a failed run has the full steps and every message you might see.
- Read a failed run helps you find the step that failed and its error.
- Run and step statuses defines each status.