Find and fix issues using the run view in the workflow editor.
Open a run
- Open your workflow and switch the sidebar to the Runs tab to see recent runs.
- Filter the list by status (Running, Completed, Failed, Cancelled, Pending), pick a date range, or toggle Show debug runs.
- Click a run to open it in the Live tab. The clock button jumps to the latest run; keep Auto-follow on to track new runs as they start.
- Use the copy-link button in the run header to share a permalink to that exact run.
The Workflows list also shows each workflow's last run status, and its Activity sidebar carries the same run list and run view.
Read the run
- The run header shows status, duration, who started the run, and which trigger fired. It identifies the exact numbered Release used for production, including branch provenance when relevant, or marks an editor execution as a Test run from a Draft.
- Expand Inputs and Results to see the data the run started with and what it produced.
- Steps appear in execution order; steps that ran concurrently are grouped as parallel. Failed and running steps expand automatically, and the last step opens because it carries the run's result.
- Expand a step to view its inputs, outputs, timing, and errors. API Request steps show the response status, body, and collapsed headers.
- While a run executes, nodes on the canvas highlight with their step status, and node ports show last-run values.
- A run can finish with partial errors: the run header lists which nodes failed even though the run completed.
Every run freezes its graph and execution envelope at admission: runtime, services, volumes, environment, defaults, workspace policy, trust posture, and credential contract. Later Draft edits, Publishes, Restores, Starts, or Pauses cannot change that run. A Retry creates a new linked run from the same frozen source, even if another Release is now Current. Disabled nodes and edges captured in the source remain visible for context but are excluded from the executable graph.
Waiting runs
- A Human Input step suspends the run and shows a response panel in the run view — approve or reject, type a text answer, or pick from options. Answering resumes the run.
- A Wait step parks the run and resumes it automatically at the scheduled time; the run view shows when.
- A Stop step ends the run early as a success; the run view notes that downstream nodes were not scheduled.
This suspension belongs to the individual run. It is separate from a workflow being Paused, which only blocks new production entries and does not interrupt existing runs.
Fix and re-run
- Adjust node settings and click Test (Cmd/Ctrl + Enter) to verify fixes against the autosaved Draft. Editor tests are debug runs by default.
- Use Retry Run in the run actions menu on a failed or cancelled run; the new run links back to the original and uses the original run's frozen graph and execution envelope.
- Use Cancel Run to stop a running or suspended run.
- Use Copy to Draft to replace the editable Draft with the graph a run executed — useful when the Draft has moved on since the failure. This does not change the Current Release or the Running/Paused state; Publish when the copied Draft is ready for production.
Tips
- Use a Manual Start trigger for rapid iteration.
- Add Note nodes to document assumptions and expected shapes.
- Streaming steps (shell commands, coding agents, AI) show their output live in the step card while they execute.
Common issues
- API 401/403: re-authorize the Connection in Resources → Connections and verify credentials and permissions.
- Parse errors: inspect the response body in the step's details; ensure the payload is valid JSON.
- Run stuck in running: an external call may be hanging — check the step marked Live, or stop the run with Cancel Run.