Skip to content

How to build and run a workflow graph

Goal

Build a workflow as a graph — nodes you connect on a canvas — save it, and run it. The graph you save is exactly what runs: every save is a version, and running starts the current version.

Before you start

  • Workflows live at /workflows in the app (for example app.magieva.com/workflows). The page is titled Workflows: "The organization's graphs — every saved version, its estimate and its status."
  • Running a workflow uses your organization's Intelligence Tokens, like any other work.

Steps

  1. Open Workflows. The library lists your organization's graphs. Use Domain and Search (by key) to narrow it; a new organization sees No graphs found.

Step 1 — the Workflows library: Create Workflow at the top right, the Domain filter set to workflow and the Search box, and No graphs found with a Create Workflow button for an organization that has none yet

  1. Choose Create Workflow. The editor opens with a node palette on the left (Search nodes…, and groups such as Endpoints & APIs, AI & Prompts, Tools and Control flow), the canvas in the middle, and a toolbar with the workflow name, Save, JSON, the key, Run and Viewer.

Step 2 — the workflow editor for a new graph: Workflow name, not saved yet, Save, JSON, the key field, Run and Viewer in the toolbar; the node palette with Search nodes… and Endpoints & APIs; and an empty canvas reading 0 nodes · 0 connections

  1. Drag nodes from the palette onto the canvas, then drag from one node's output to the next node's input to connect them. If two ports do not fit together, the connection is refused and the editor names the type mismatch.
  2. Type a Workflow name and choose Save. The key is derived from the name on first save unless you set one. Each save becomes a new version.
  3. Choose Run to start a run of the saved version. Run stays off while the graph has unsaved changes; after you edit a saved graph, the ▶ button next to it saves a new version and runs it in one step.

Follow and manage your workflows

  • Open a graph from the library to see it with its runs. Select a run to watch it move through the graph; Edit graph takes you back to the editor, and Back to Workflows returns to the library. A graph that has never run says No runs yet. Press Run in the toolbar.
  • Versions lists every saved version. Activate an older version to make it current — nothing is copied.
  • Duplicate copies a graph under a new key, so you can change it without touching the original.

Verify it worked

Open the graph from the library: the run you started is listed under its runs, and selecting it shows how far it got.

Troubleshooting

Problem What to do
Save says to give the workflow a name or a key Type a Workflow name (or a key) before saving.
A connection will not attach The editor names the mismatch — connect ports of compatible types, or add a node in between that converts.
Run is not available Save the graph first — runs always start from a saved version, and Run stays off while there are unsaved changes (use ▶ to save and run).
  • How to schedule a recurring or before-event automation