Skip to main content
PUT
JavaScript

Authorizations

Authorization
string
header
required

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

Path Parameters

planId
string<uuid>
required

The ID of the run plan to update

Body

application/json

Input for updating an existing simulation run plan

isHidden
boolean

Whether this plan is hidden from GET /v1/simulation/plan.

A run started without saveAsPlan creates a hidden plan to carry it. Send { "name": "...", "isHidden": false } to keep that configuration as a reusable plan, which is what the app does when you save a one-off run.

name
string

Name of the run plan

Minimum string length: 1
description
string

Description of the run plan

direction
enum<string>

Direction of the simulation (INBOUND or OUTBOUND)

Available options:
INBOUND,
OUTBOUND
iterationCount
integer

Number of iterations to run for each test case (1-10000)

Required range: 1 <= x <= 10000
maxConcurrentJobs
integer

Maximum number of concurrent simulation jobs

Required range: x >= 1
maxSimulationDurationSeconds
integer

Maximum duration in seconds for each simulation

Required range: x >= 1
silenceTimeoutSeconds
integer

Timeout in seconds for silence detection

Required range: x >= 1
endCallPhrases
string[]

Phrases that trigger end of call. Empty array disables the feature.

endCallReasons
string[]

Semantic conditions that trigger end of call. The LLM evaluates the conversation against these conditions. Empty array disables the feature.

executionMode
enum<string>

Execution mode (PARALLEL or SEQUENTIAL)

Available options:
PARALLEL,
SEQUENTIAL_SAME_RUN_PLAN,
SEQUENTIAL_PROJECT
scenarios
object[]
deprecated

Deprecated: use flows instead. Replaces the scenarios on this run plan. Omit to leave them unchanged; send an empty array to detach them all, which is how a scenario-based plan is moved over to flows.

flows
object[]

Replaces the customer flows attached to this run plan. Omit to leave them unchanged; send an empty array to detach them all.

personas
object[]

Personas to include in this run plan

Minimum array length: 1
agentEndpoints
object[]

Agent endpoints to include in this run plan

Minimum array length: 1
metrics
object[]

Metric definitions to include in this run plan. Reference each by id (UUID) or slug.

Minimum array length: 1

Response

The updated run plan

data
object
required

A simulation run plan defining the test matrix