Skip to content

Troubleshoot workflow runs

Diagnose queued, blocked, or failed workflow runs and rerun them safely.

Open the workflow’s run history and select the affected run. Start with its overall status, then inspect the first step that did not complete.

Diagnose the run first

Read the overall status

Determine whether the run is queued, waiting, failed, or could not start. The status identifies the next part of the run to inspect.

Open the first incomplete step

Review that step’s input, output, error, or pending approval before changing the workflow.

Correct the cause before retrying

Fix invalid input, workflow configuration, connection access, or the pending decision. Then choose retry or start a new run based on what changed.

Fix the matching symptom

A run may wait when the workspace is already using its allowed concurrency. Queued runs are not dropped; wait for an active run to finish instead of starting duplicates.

Review validation messages for missing or invalid input. Edit the workflow or provide the requested input, then start a new run.

Open the failed step and review its input and error. Common causes include invalid data, a provider error, or a missing connection. Correct the source data or configuration before retrying.

Open the pending approval and review the proposed action, target account, and changes. Approve it to continue or reject it to stop that action. Do not recreate the action manually and then approve the original request as well.

Use retry when the existing run offers it and the input is still correct. If you changed the workflow or its inputs, save the edit and start a new run so the history reflects the new configuration.

Confirm the account is active, attached to the agent, and allowed by its tool policy. Reconnect expired accounts before rerunning.

Continue from here

Navigation