Skip to main content
The automation builder is the dashboard UI for the same canonical definition used by the API.

Layout

  • Center React Flow canvas
  • Compact status and version controls above the canvas
  • Right-side inspector for trigger, step, and branch configuration
  • Right-side step library for trigger, logic, wait, and action nodes
  • Top header actions for validate, save draft, publish, pause, and resume

How it maps to the API

The builder saves:
  • definition: executable trigger, steps, and connections
  • editor_layout: node positions and viewport metadata
The runtime only executes definition. The canvas layout is UI metadata.

Best practices

  • Publish templates first so send steps can reference published versions.
  • Use descriptive step keys so run timelines stay readable.
  • Keep v1 graphs acyclic.
  • Use wait_for_event timeouts for fallbacks instead of loops.