Skip to content

Commit 366fdcf

Browse files
ouiliameclaude
andcommitted
docs(workflows): errors are execution semantics — own section on how-it-runs
Failure behavior was buried inside 'Watching a run' (the live-UI section). Now a first-class 'When a block fails' section in the execution story: an error fails the run (in-flight blocks finish, nothing new starts) unless the block's error port is connected, in which case the run follows the error path. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
1 parent 774d3a7 commit 366fdcf

1 file changed

Lines changed: 5 additions & 1 deletion

File tree

apps/docs/content/docs/en/workflows/how-it-runs.mdx

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -38,9 +38,13 @@ To repeat work, a [Loop](/blocks/loop) block runs its inner blocks over a list,
3838
A workflow can call other workflows, through a Workflow block, an MCP tool, or an API block. Sim tracks the call chain and stops a run that exceeds 25 hops, so workflows that call each other can't loop forever.
3939
</Callout>
4040

41+
## When a block fails
42+
43+
A block that errors fails the run: blocks already running finish, and nothing new starts. To handle the failure instead, connect the block's **error port** — the run follows the [error path](/workflows/connections) and continues.
44+
4145
## Watching a run
4246

43-
While a workflow runs, the editor shows each block's state live: queued, running, done, or errored. When a block fails, the run fails with it — blocks already running finish, but nothing new starts. The exception is a block with its error port connected: the failure routes down the [error path](/workflows/connections) and the run continues. Every run is recorded, so you can open the [logs](/logs-debugging) to see what each block received and returned after it finishes.
47+
While a workflow runs, the editor shows each block's state live: queued, running, done, or errored. Every run is recorded, so you can open the [logs](/logs-debugging) to see what each block received and returned after it finishes.
4448

4549
## Next
4650

0 commit comments

Comments
 (0)