Skip to main content

Versions, publishing, and run history

Runs execute the published version of a Flow; the draft you edit in the builder is yours until you publish it. Every run is recorded against the version it executed.

Publish a version

In the builder, resolve errors under Flow → Validation, select Save draft, then Publish. The Versions list marks the current, published, and immutable versions - published versions never change; saving on top of one creates the next draft.

To roll back, choose an immutable version in Versions, select its Publish action, and confirm Publish this version. Runs start using it immediately, while your current draft remains untouched.

Published history is retained. You can move live use to another published version, but you cannot turn a published Flow back into a never-published draft.

Read the run history

Open the Flow and select Runs. The page shows totals - runs, succeeded, failed, p50/p95 duration - and every run of the published definition, newest first, with its status, input, starter, and duration.

The Runs page for a refund flow: totals, then runs awaiting approval, succeeded, and failedThe Runs page for a refund flow: totals, then runs awaiting approval, succeeded, and failed

Run statuses:

StatusMeaning
QueuedAccepted, not yet started.
RunningExecuting now - includes a parallel parent with live branches, and a poll between attempts.
Awaiting approvalParked for a human: an approval gate or a human task.
WaitingParked on the clock by a wait step - deliberately not "running".
SucceededFinished; output recorded.
FailedStopped on an unrouted error; the failing step carries the code and message.
CancelledStopped by a person from Monitor.
Timed outExceeded its execution budget.
A flow run's session: the Run view with each step, its result, and the data that reached itA flow run's session: the Run view with each step, its result, and the data that reached it

Open a run to see its steps and data in the session Run view - the conversations themselves are under Sessions.

Webhooks on completion

A Flow can notify an external system when runs complete or fail - configure webhooks from the Flow's Webhooks control, and see Webhooks for delivery, signing, and retries.

Tips

If a run is missing from the list, check whether it was a Test run - draft test runs are audited but kept out of statistics. If Publish says the definition is not ready, the validation checklist names each blocker. See Troubleshooting.