> ## Documentation Index
> Fetch the complete documentation index at: https://docs.argalabs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# POST Run a test

> Execute a saved browser-agent test

```bash theme={null}
POST /runner/tests/{test_id}/run
```

**Request body**

| Field         | Type            | Required | Description                                                                                                                                                      |
| ------------- | --------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `start_url`   | `string`        | No       | Override the saved start URL.                                                                                                                                    |
| `prompt`      | `string`        | No       | Override the saved prompt.                                                                                                                                       |
| `sandbox_id`  | `string`        | No       | Ready sandbox to run the test against. When present and `start_url` is omitted, the sandbox app URL is used. If the sandbox is not ready, the API returns `409`. |
| `twins`       | `array<string>` | No       | Twins recorded in the run event metadata. This route does not provision twins by itself.                                                                         |
| `ttl_minutes` | `integer`       | No       | TTL recorded in the run event metadata. This route does not manage twin lifetime by itself.                                                                      |
| `session_id`  | `string`        | No       | Session id metadata for the run event.                                                                                                                           |