Skip to main content
POST
/
v1
/
agent-testing
/
simulation-sets
Create Simulation Set
curl --request POST \
  --url https://api.bland.ai/v1/agent-testing/simulation-sets \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --data '
{
  "scenario_ids": {},
  "simulations_per_scenario": 123,
  "pathway_id": "<string>",
  "persona_id": "<string>",
  "version_number": 123
}
'
{
  "simulation_set_id": "d4e5f6a7-89ab-cdef-0123-4567890abcde",
  "status": "PENDING",
  "simulations_per_scenario": 5,
  "total_scenarios": 3,
  "created_at": "2026-04-14T10:00:00.000Z"
}

Documentation Index

Fetch the complete documentation index at: https://docs.bland.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Headers

​
authorization
string
required
Your API key for authentication.

​
Body

​
scenario_ids
array of strings
required
Scenario IDs to include. All scenario IDs must belong to your organization.
​
simulations_per_scenario
integer
required
Number of times to run each scenario. Must be >= 1.
​
pathway_id
string
The pathway ID.
​
persona_id
string
The persona ID.
​
version_number
integer
Pathway version to test.
This endpoint is rate limited. All scenario_ids must belong to your organization.

​
Response

​
simulation_set_id
string
The unique identifier for the newly created simulation set.
​
status
string
The initial status of the simulation set. Will be PENDING upon creation.
​
simulations_per_scenario
integer
The number of simulations that will be run per scenario.
​
total_scenarios
integer
The total number of scenarios included in this set.
​
created_at
string
ISO 8601 timestamp of when the simulation set was created.
{
  "simulation_set_id": "d4e5f6a7-89ab-cdef-0123-4567890abcde",
  "status": "PENDING",
  "simulations_per_scenario": 5,
  "total_scenarios": 3,
  "created_at": "2026-04-14T10:00:00.000Z"
}
Docs for agents: llms.txt