> ## 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.

# Create Simulation Set

> Create a simulation set that runs each scenario multiple times to detect flaky behavior. Returns immediately while simulations execute asynchronously.

### 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.

> [!NOTE]
>
> 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.

```json Response theme={null}
{
  "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](https://docs.bland.ai/llms.txt)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.