Skip to main content
An environment enters Needs investigation when one or more flows fail in a run. An environment enters Failed status when one or more flows mapped to high-priority bug reports fail. These states indicate that one or more runs require resolution before the release should proceed.
Failed flows and environment status provide a release signal. If you want runs in Failed status to block releases, ask your Customer Success Manager about our CI Greenlight feature.
A run that contains failed flows remains in Investigating or Failed as long as any failed flow has not been resolved. A failed flow is considered resolved when one of the following occurs:
  • The flow passes on a subsequent attempt, including when a temporary environmental issue resolves.
  • The flow is fixed, and the updated version is applied to the run.
  • The underlying application issue causing the failure is fixed.
  • A maintenance report is filed, preventing the flow from being included in runs until it is fixed.
A run transitions to Completed only after all failed flows have been resolved. Once all runs are completed, the environment exits the Needs investigation or Failed status and can be considered ready for release.
Reattempting all failures in a run is appropriate when all failures in the run are believed to be caused by a bug or a temporary environment glitch.
1
Open the Runs tab and click the run that is in Investigating or Failed status. This will open the Investigation view
2
Click the icon to open the context menu.
3
Choose Reattempt with latest version. This will take you to the investigation view and run only the failed flows. Use this option when you want to quickly check that the suspected temporary glitch has resolved
4
Choose Duplicate run. This will be a full retry of all flows, including up to three attempts. Use this option after you have validated that the temporary problem has been resolved, but you want to see if the issue was blocking any deeper problems
Bypassing a failed flow is appropriate when the failure is understood and should not block the release, even if the flow has not passed (e.g., an understood failure in a third-party dependency). Bypassing does not fix the flow or the underlying issue. Instead, it records that the failure has been reviewed and does not require further investigation for the current release.To bypass a failed flow:
1
Open the Runs tab and select a run in Investigating or Failed status.
2
Select the failed run that contains the flow that doesn’t need further investigation
3
Click Diagnose in the center panel.
4
Select Do not investigate.
Once a failed flow is marked as Do not investigate, it is considered resolved for the run. When all failed flows in the run have either passed or been bypassed, the run transitions to Completed.
You can also find Diagnose by hovering over the failing flow to show the icon, then clicking it to show the icon. Diagnose will appear below the Flow list
1
From the Runs tab, select the environment in the from list on the upper left.
2
In the center panel, select a run from Investigating list.
3
In the Investigation view, click Edit code to open the flow for changes.
4
Click Run code.
5
When the flow fails, click the Ask https://mintcdn.com/qawolf/RMS__NcKrv-xuMe0/images/execution-scheduling-bugs-and-maintenance/QA_Wolf_mark.svg?fit=max&auto=format&n=RMS__NcKrv-xuMe0&q=85&s=ae559e63b32ea7de85fbbfc1414628d1 next to the failed line to get AI help analyzing and updating the code. AI will make changes to your code in place and show its reasoning in the right panel.
6
When satisfied with the changes, review and publish your changes.
7
Click Use as reattempt. The flow should pass and will move to the Completed section of the runs tab.
Some failures represent real issues but are not practical to fix during the current release. In these cases, the appropriate action is to document the work required and allow the release to proceed.Follow-up work generally falls into two categories:For bugs
  • File a bug report When you file a bug report, the severity is used to display warnings about the safety of a given release.
For flow maintenance
  • File a maintenance report This prevents the flow from being executed in runs until it is fixed, which resolves the investigation state without requiring an immediate fix.
Last modified on February 9, 2026