Skip to main content
PUT
Update Simulation
Integration Prompt for AI Agents
New: agent_version_idDeprecated: prompt_id. Same uuid, still works. If both are sent and they differ, the request is 400.
Update a specific simulation by ID. Only fields provided in the request body will be updated.

Headers

X-Organization-Id
string
X-API-Key
string
required

API key required to authenticate requests.

Path Parameters

simulation_id
integer
required

Body

application/json

request body for updating a simulation.

all fields are optional; only provided fields will be updated.

bluejay_as_code_id
string<uuid> | null

Stable code-addressable identifier

name
string | null

updated simulation name

description
string | null

human‑readable description of the simulation

prompt_id
string<uuid> | null
deprecated

Deprecated. Use agent_version_id. Same uuid, still works.

agent_version_id
string<uuid> | null

optional default agent version UUID for this simulation

knowledge_base_id
string<uuid> | null

optional default knowledge base UUID for this simulation

max_concurrent
integer | null

maximum number of concurrent runs (max 500)

Required range: 0 < x <= 500
hangup_on_transfer
boolean | null

whether to hang up the call on transfer

max_call_duration
integer | null

maximum duration of each call. units specified by max_call_duration_units

max_call_duration_units
enum<string> | null

units for max_call_duration: 'minutes' or 'seconds'

Available options:
minutes,
seconds
max_turns
integer | null

maximum number of turns per simulation run

ringing_timeout
integer | null

ringing timeout in seconds before abandoning

digital_humans_settings
Digital Humans Settings · object | null

settings for digital humans in the simulation

selected_custom_metrics
string<uuid>[] | null

array of custom metric IDs to be saved in settings

custom_metrics_failing_threshold
integer | null

score threshold below which a custom metric is considered failing (0-100)

Required range: 0 <= x <= 100
custom_metrics_passing_threshold
integer | null

score threshold at or above which a custom metric is considered passing (0-100)

Required range: 0 <= x <= 100
outcome_failing_threshold
integer | null

outcome score threshold below which the simulation is considered failing (0-99)

Required range: 0 <= x <= 99
outcome_passing_threshold
integer | null

outcome score threshold at or above which the simulation is considered passing (1-100)

Required range: 1 <= x <= 100
runs_per_digital_human
integer | null

number of simulation runs to execute per digital human

Required range: x > 0
delay_between_tests_seconds
number | null

seconds to wait after a test completes before the next launches (0 = off)

Required range: 0 <= x <= 300
inactivity_timeout_seconds
integer | null

seconds to wait for an agent reply before ending a text conversation (300-1800 = 5-30 min); defaults to 300 when unset

Required range: 300 <= x <= 1800
tags
string[] | null

array of tags for the simulation

pinned
boolean | null

whether the simulation is pinned

custom_error_enabled
boolean | null

enable custom-error detection for this simulation

custom_error_prompt
string | null

custom-error definition prompt; overrides the org default when set

enable_rerun_failed_test_results
boolean | null

per-sim override of the org rerun-on-failure flag

enable_rerun_on_custom_error
boolean | null

per-sim override of the org rerun-on-custom-error flag

rerun_max_retries
integer | null

max same-run reruns of a failed result (1-5)

Response

Successful Response

agent_id
integer
required
name
string
required
type
enum<string>
required
Available options:
max_concurrent,
parallel
id
integer | null
bluejay_as_code_id
string<uuid> | null
created_at
string<date-time> | null
updated_at
string<date-time> | null
updated_by
string<uuid> | null
created_by
string<uuid> | null
settings
Settings · object | null
max_concurrent
integer | null
max_turns
integer | null
ringing_timeout
integer | null
inactivity_timeout_seconds
integer | null
tags
string[] | null
description
string | null
pinned
boolean | null
always_on
boolean | null