Skip to main content
GET
Get Scenario

Authorizations

Authorization
string
header
required

Use Tuner API key (tr_api_...) or user session token. Find your API key in Workspace Settings > API Keys.

Path Parameters

scenario_id
integer
required

ID of the scenario

agent_id
string
required

Tuner's numeric agent ID, or your Agent ID from Agent Settings > Agent Connection. Digits-only values are read as the numeric ID.

workspace_id
integer
required

Workspace ID. Find this in Workspace > General Settings.

Response

Successful Response

Response schema for a single library scenario.

id
integer
required

Scenario ID.

agent_id
integer
required

ID of the agent the scenario belongs to.

workspace_id
integer
required

ID of the workspace the scenario belongs to.

name
string
required

Name of the scenario.

type
string
required

routine or pressure.

format
string
required

How the caller follows the scenario. Currently always freeform.

origin
string
required

How the scenario entered the library: manual or ai_saved.

situation
string
required

The situation the simulated caller is in.

goal
string | null
required

What the caller is trying to achieve.

first_line
string | null
required

Exact opening line the caller speaks first.

stop_condition
string | null
required

When the caller should hang up.

intent_id
integer | null
required

ID of the call intent the scenario exercises.

target_ai_evaluation
Target Ai Evaluation · object | null
required

The eval or call outcome the scenario targets, as type and value.

tags
string[] | null
required

Free-form labels on the scenario.

source_run_id
integer | null
required

ID of the simulation run the scenario was saved from, if any.

created_at
string<date-time>
required

When the scenario was created.

updated_at
string<date-time>
required

When the scenario was last updated.

last_run
ScenarioExecutionItem · object | null

The scenario's most recent execution. Only populated by List Scenarios; null if the scenario has never been run.