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

<ParamField header="authorization" type="string" required>
  Your API key for authentication.
</ParamField>

### Body

<ParamField body="scenario_ids" type="array of strings" required>
  Scenario IDs to include. All scenario IDs must belong to your organization.
</ParamField>

<ParamField body="simulations_per_scenario" type="integer" required>
  Number of times to run each scenario. Must be >= 1.
</ParamField>

<ParamField body="pathway_id" type="string">
  The pathway ID.
</ParamField>

<ParamField body="persona_id" type="string">
  The persona ID.
</ParamField>

<ParamField body="version_number" type="integer">
  Pathway version to test.
</ParamField>

<Note>
  This endpoint is rate limited. All `scenario_ids` must belong to your organization.
</Note>

### Response

<ResponseField name="simulation_set_id" type="string">
  The unique identifier for the newly created simulation set.
</ResponseField>

<ResponseField name="status" type="string">
  The initial status of the simulation set. Will be `PENDING` upon creation.
</ResponseField>

<ResponseField name="simulations_per_scenario" type="integer">
  The number of simulations that will be run per scenario.
</ResponseField>

<ResponseField name="total_scenarios" type="integer">
  The total number of scenarios included in this set.
</ResponseField>

<ResponseField name="created_at" type="string">
  ISO 8601 timestamp of when the simulation set was created.
</ResponseField>

<ResponseExample>
  ```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"
  }
  ```
</ResponseExample>

***

Docs for agents: [llms.txt](/llms.txt)