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

# Run Test Scenario

> Execute a single test scenario. Returns immediately with a run ID while the test executes asynchronously.

### Headers

**authorization** `string` *required*

Your API key for authentication.

### Path Parameters

**id** `string` *required*

The scenario ID to run.

### Body

**version\_number** `integer`

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

**request\_data\_override** `object`

Override the scenario's `request_data` for this run. Any keys provided here will replace the corresponding keys in the scenario's default request data.

**webhook\_url** `string`

URL to receive a webhook when the run completes. The webhook payload will include the full run result.

### Response

**run\_id** `string`

The unique identifier for the test run.

**status** `string`

The current status of the run. Will be `RUNNING` immediately after creation.

```json Response theme={null}
{
  "run_id": "a3f1b2c4-5d6e-7f8a-9b0c-1d2e3f4a5b6c",
  "status": "RUNNING"
}
```

> [!NOTE]
>
> This endpoint is rate limited per organization. If you need to run multiple scenarios at once, consider using the [Batch Run](https://docs.bland.ai/api-v1/post/agent-testing-batch-run.md) endpoint instead.

***

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.