Skip to main content
Updates a flow’s title, description, branching mode, linked agents or flow-level expectations. The step graph is replaced through PUT /graph.
Calls PUT /v1/customer-flow/{flowId}

​
Arguments

​
string
required
The flow-id.

​
Options

​
string
​
string
​
string
Scripted flows only. How closely a run follows the script. LOOSE (default) hands the whole script to the simulated customer as one prompt; it keeps the call moving whatever your agent says. STRICT runs the script as a state machine on the agent service: at every agent step the simulated customer waits, silent, until your agent has said the expected line, and only then moves on. Scripted flows only; STRICT needs the agent-service transport and is not available on realtime models. One of LOOSE, STRICT
​
object
STRICT only. What the simulated customer does when your agent does not say the expected line. Each unmatched agent utterance is an attempt: reaction runs per attempt (STAY_SILENT, REPEAT its last scripted line, RESPOND once in character without moving on, or SAY sayLine), and then runs when attempts reach maxAttempts or your agent stays silent for waitSeconds (HANG_UP ends the call with ended reason SCRIPT_DIVERGED, HANG_UP_INVALIDATE ends it the same way and invalidates the run so it is scored by nothing and counted nowhere, MOVE_ON advances anyway, ADAPT hands the rest of the call to loose behaviour). Null: stay silent, 3 attempts, hang up. The default for every agent step; an AGENT_TURN step can carry its own.
​
string
required
One of STAY_SILENT, REPEAT, RESPOND, SAY
​
string
​
integer
required
​
string
required
One of HANG_UP, MOVE_ON, ADAPT, HANG_UP_INVALIDATE
​
integer
​
string
Scripted flows only. How a run walks the graph. DETERMINISTIC (“Simulate every path” in the app) places one call per variant, each following its path exactly whatever the agent says. ADAPTIVE (“Adapt to your agent”) collapses the paths into one call PER PERSONA, on which the simulated customer picks a branch from what the agent actually said. Both modes speak the exact authored lines, and neither changes how metrics or expectations grade. One of DETERMINISTIC, ADAPTIVE
​
array
Replaces the linked agents. Omit to leave them unchanged. An improv flow must keep at least one; a scripted flow can be left with none. Repeatable.
​
array
Replaces the flow-level expectations. Omit to leave them unchanged.

​
Example

Every command also takes the global options and sets one of the exit codes.