Edit a flow with AI

How it works

Administrator or Sandbox developer with a user access token required; integration keys are excluded. Pass the current definition and optional selection {nodeId,output:next|yes|no|rejectedNext|null}. A blank two-node flow anchors after the trigger. Select a branch for multi-output steps; ambiguous placement returns questions and definition:null. Enter submits in the designer; Shift+Enter adds a line. The search icon retains node finding.

Returns merged definition, summary, questions, assumptions, unresolvedGroups, model and changes {added,updated,removed,fields,documents,connections}. The API generates a suggestion without saving or executing it. Applying an email trigger change in the designer saves the draft to allocate or revoke its address. No publication or process start occurs. Preserve local geometry and reject a response if the draft changed while waiting. The designer retains existing positions, places only new nodes and supports undo of up to ten consecutive AI edits. Manual semantic changes disable the previous AI undo; manual movement survives undo.

Only design context and group names are sent to the EU-verified provider. Existing fixed guest emails are redacted; recipient settings cannot be AI-updated. No execution data, memberships, document bytes or URLs are loaded. Unknown groups remain unresolved. The existing AI draft budget applies; 3,000 prompt characters, 128 KiB body, at most 12 added/12 updated nodes and 40 connections per response, 40 total nodes. Invalid/cyclic changes are rejected atomically. No Idempotency-Key is needed; retries consume another AI reservation.

AI is disabled by default per organization and environment. An administrator must explicitly enable external AI processing under Organization → Privacy. Never include credentials or confidential personal information. Local keyword search remains available with smart=false.

Request body

Request essentials

Authorization

Bearer $FLOWG8_ACCESS_TOKEN

X-Organization-Id

Your workspace UUID

Idempotency-Key

Stable per operation; 8–128 characters