# run_scenario

Run a multi-device scenario, a file or a saved routine; returns a run to follow.

Run a multi-device scenario, a file or a saved routine; returns a run to follow.

| | |
|---|---|
| REST operation | [`startRun`](/reference/rest/runs/#startrun) (`POST /v1/runs`) |
| Needs a device | no |
| Read only | no |
| Profiles | `testing`, `full` |

## Parameters

| Name | Required | Type | Goes to | What it is |
|---|---|---|---|---|
| `yaml` | no | string | body `scenario.yaml` | Scenario in Silan YAML. |
| `path` | no | string | body `scenario.path` | Path to a scenario file on this Mac. Refused over the relay. |
| `routine_id` | no | string | body `routineId` |  |
| `bindings` | no | object | body `bindings` | Role name to device id (or to a list for many-users roles). Unbound roles are matched automatically. |
| `params` | no | object | body `params` |  |
| `record` | no | boolean | body `record` |  |

## Example call

```text
run_scenario({})
```