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

# roark simulation plan job start

> Run a simulation plan

Deprecated: use POST /v1/simulation/run, which does the same thing and can also take the plan configuration inline, so a one-off run does not have to create a plan first. Creates and executes a job for an existing simulation run plan. Optionally provide runtime variables to override plan-defined variables.

```bash Synopsis theme={"theme":{"light":"everforest-light","dark":"everforest-dark"}}
roark simulation plan job start <plan-id> [options]
```

> [!NOTE]
>
> Calls `POST /v1/simulation/plan/{planId}/job`

## Arguments

**plan-id** `string` *required*

Simulation run plan ID.

## Options

**--variables** `string`

Values for the \{\{variables}} the run resolves, overriding whatever the plan has pinned. An object applies them to the whole run: \{ "orderNumber": "12345", "tier": "gold" } An array applies them per flow, or to just its happy path or one of its edge cases, when a single set will not do. Each entry carries what it applies to: \[ \{ "flowId": "550e8400-...", "variables": \{ "orderNumber": "12345" } }, \{ "flowId": "550e8400-...", "happyPath": true, "variables": \{ "orderNumber": "55555" } }, \{ "flowId": "550e8400-...", "edgeCaseId": "7a3d2e1f-...", "variables": \{ "orderNumber": "67890" } } ] An entry that narrows to neither covers everything that flow resolves. A flow this plan does not attach, or an edge case that does not belong to the flow, is rejected rather than ignored. A plan built on scenarios rather than customer flows targets them the same way, with `scenarioId` in place of `flowId`. That form is deprecated alongside scenarios themselves, and still accepted so runs against those plans keep working.

## Example

```bash theme={"theme":{"light":"everforest-light","dark":"everforest-dark"}}
roark simulation plan job start <plan-id>
```

Every command also takes the [global options](/cli-reference/overview.md#global-options) and sets one
of the [exit codes](/cli-reference/overview.md#exit-codes).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.