Skip to main content
POST
Update scenario
Update a scenario’s name, nodes_json, and optional LLM model. Required request fields:
  • id of the scenario to update
  • name
  • nodes_json
If you send hosted_links, the array is a full replace. Links omitted from the array are deleted. Include each existing link’s id to keep or edit it. Omit hosted_links entirely to leave existing links unchanged.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
id
string<uuid>
required
name
string
required
nodes_json
object
required

Scenario flow JSON. See the Using JSON guide for the full contract.

llm_model
enum<string>

OpenAI chat model for this scenario. Defaults to gpt-4.1-mini. Full-size models require a paid plan.

Available options:
gpt-4.1-nano,
gpt-4.1-mini,
gpt-4.1,
gpt-5.4-nano,
gpt-5.4-mini,
gpt-5.4

If present, this array is the full set of hosted links after the update. Links omitted from the array are deleted. Omit this field to leave existing links unchanged.

Response

Scenario updated successfully

status
string
required
id
string<uuid>
required
redirect_url
string

Dashboard path. Ignore for API clients.