> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gloo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Graph Builder (v2)

> Edit a workflow graph on a canvas: add nodes, wire edges, set inputs and settings, test-run a draft, verify wiring, and publish a new version or roll back.

**Graph Builder (v2)** (`/production/workflows/builder-v2`) is the canvas editor for a workflow's graph. It has no sidebar entry of its own: you reach it from **Edit graph** on a workflow's detail page, from **Fix with Architect** on a failed run, or by its URL. Open it to change a draft's nodes, edges, inputs, and settings, then test and publish that draft as a new version.

> [!WARNING]
>
> Opening `/production/workflows/builder-v2` with no `draftId` or `versionId` in the URL creates a new draft workflow named `untitled-workflow-<timestamp>` and redirects to it. Every visit to the bare URL adds another untitled workflow to the catalog.

![Graph builder](https://mintcdn.com/gloo-b243725a/Ndtg9NEpwGc2OULA/forge/images/console/production/graph-builder-light.png?fit=max\&auto=format\&n=Ndtg9NEpwGc2OULA\&q=85\&s=a045a6235a7de6552e68ef5dd71e56f1)

Graph builder — Forge Console at `/production/workflows/convex/builder-v2`

## Modes

The badge next to the workflow name tells you which document you are looking at.

| Badge | Opened with | What you can do |
| - | - | - |
| **Editing Draft** | `?draftId=` | Edit the graph, inputs, and settings; test-run; publish |
| **Viewing v{n} · active** | `?versionId=` of the active version | Read-only; **Run** the version |
| **Viewing v{n} · superseded** | `?versionId=` of an older version | Read-only; **Rollback to v{n}** |

The version switcher next to the badge moves between the draft and published versions. Adding `architectOpen=1` to the URL opens the Architect dock on load.

## What you can do

On a draft:

* Click the workflow name to rename it.
* **Open Panel** / **Hide Panel** shows or hides the dock. The dock has three segments: **Architect** (chat with the workflow Architect), **Properties** (the selected node or edge), and **Inputs** (the workflow's typed input contract).
* **Add node** on the canvas opens the node launcher.
* **Settings** opens **Workflow Settings**, the global defaults applied across all nodes.
* **Test run** launches a one-off test run against the draft through the run dialog.
* **Verify wiring** runs pre-publish wiring checks and shows the result in a **Wiring check** panel.
* **Publish** opens **Publish draft as new version**. Publishing creates an immutable version, makes it the active workflow, and demotes the current active version to superseded. Add an optional **Publish note**.

On a published version:

* **Run** opens the run dialog for the active version.
* **Rollback to v{n}** makes a superseded version active again.
* **Debug preview** appears on a version when the `workflow_debug_execution` feature flag is on.

## Publish outcomes

**Publish** is disabled while validation runs ("Validating…") and while the draft has validation errors (the tooltip gives the count). In the publish dialog:

* Unresolved capability gaps or a fail verdict from the Architect quality judge switch the buttons to **Fix first** and **Publish anyway**. **Publish anyway** requires an **Override reason**, which is recorded as an audit event with your identity.
* An authority refusal shows "You are not entitled to publish this version", or "Say which companies these Credential bindings may name" when a Credential binding names no companies.

## Who can act

* **Test run**, **Verify wiring**, and **Publish** need `workflows:write`.
* **Run**, **Rollback to v{n}**, and **Debug preview** need `workflows:use`.

## Key state to watch

* **Editing Draft** versus **Viewing v{n}**: edits apply only to a draft. A version view is read-only.
* A disabled **Publish** button with an error count: fix each validation error before publishing.
* A **Wiring check** that lists errors: runtime dispatch fails on those nodes until they are resolved.
* **Publish anyway** after a judge warning: the version publishes, and the override reason sits in the audit trail; review the verdict before running the version.

## Related surfaces

* [Workflows](https://docs.gloo.com/forge/console/production/workflows)
* [Runs](https://docs.gloo.com/forge/console/production/runs.md)
* [Fiscal Calendars](https://docs.gloo.com/forge/console/platform/fiscal-calendars.md)
* [Synthesis Settings](https://docs.gloo.com/forge/console/platform/synthesis-settings.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.