Understanding a flow
Every flow tells a short story: what starts it, what it does, who does the work and what happened recently. This page shows you how to read that story in the flow list and in a flow's detail panel.
Read a flow in the list
On Automation → Flows, each row shows:
A status dot and the flow name. A Missing agent or Setup incomplete tag means the flow can't run until you fix it.
The logic in one line. When is followed by the trigger, labelled with its kind (Task, GitHub, GitLab, Approval or Schedule), then an arrow and the action (Agent, Task or Branch).
Runs, Last run and Next run. Event-driven flows show On trigger as the next run. Paused flows show Paused.
If the flow's last run failed, the error message appears under the row.
Open the detail panel
Select a flow to open its detail panel. It shows the flow's description, followed by these sections.
Logic
Row | Shows |
|---|---|
When | The trigger and any filters, such as the repository or branch |
Then | The action, such as Start an agent run |
Using | The agent, Built-in action for flows without an agent, or Not connected if the agent is missing |
On | Where the agent works: the item that triggered the flow, a specific item, or your workspace |
Stats
Total runs – how many times the flow has run.
Errors – how many runs failed. The number turns red when there are errors.
Last run – when it last ran.
Next run – the next scheduled time, On trigger for event flows, or Paused.
Recent runs
The latest runs appear with their status (Completed, Running, Queued, Failed, Needs attention or Cancelled), the item they worked on, and when they started. Select a run to open it in Activity, or select View all to see the flow's full history. If the flow hasn't run, you'll see No runs yet.
Actions
The buttons at the bottom let you Pause flow or Enable flow, Edit flow, Run now (scheduled flows only) and Delete. Which buttons you see depends on your permissions. See Edit, pause and delete flows.
Flow status
Status | Meaning |
|---|---|
Active | The flow is on and will run when triggered |
Paused | The flow is turned off |
Errored | The flow recently hit an error |
Needs review | Something from the flow is waiting for review |
Incomplete | Required setup, such as the agent or destination state, is missing |
Playbook managed | The flow belongs to a CRM playbook and is managed there |
Related articles
Was this article helpful?