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

# Batch Run Scenarios

> Execute multiple test scenarios as a batch. Returns immediately with a batch ID while tests execute asynchronously.

### Headers

**authorization** `string` *required*

Your API key for authentication.

### Body

**scenario\_ids** `array of strings` *required*

Array of scenario IDs to run. All scenario IDs must belong to your organization.

**version\_number** `integer`

Pathway version to test. Defaults to the current production version.

**webhook\_url** `string`

URL to receive a webhook when the entire batch completes. The webhook payload will include the batch result summary.

### Response

**batch\_id** `string`

The unique identifier for the test batch.

**runs** `array of objects`

An array of run entries, one per scenario. Each entry contains:

* `run_id` - The unique identifier for the individual test run.
* `scenario_id` - The scenario ID associated with this run.

```json Response theme={null}
{
  "batch_id": "e7a2c3d4-8f9b-4a1e-b5c6-d7e8f9a0b1c2",
  "runs": [
    {
      "run_id": "a3f1b2c4-5d6e-7f8a-9b0c-1d2e3f4a5b6c",
      "scenario_id": "1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d"
    },
    {
      "run_id": "b4c2d3e5-6f7a-8b9c-0d1e-2f3a4b5c6d7e",
      "scenario_id": "2b3c4d5e-6f7a-8b9c-0d1e-2f3a4b5c6d7e"
    }
  ]
}
```

> [!NOTE]
>
> This endpoint is rate limited per organization. All `scenario_ids` must belong to your organization or the request will be rejected.

***

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.