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

> Create a run plan

Creates a new simulation run plan. To run a simulation, use POST /v1/simulation/run instead: it starts a run from a plan or from an inline configuration, and takes runtime variables. Create a plan here when you want a reusable, named one to run later. Send `template` instead of a full configuration to save one of the built-in templates as a plan. It takes the same fields as the template variant of POST /v1/simulation/run, builds the same plan, and never starts it. To compare one property, attach the flow once and send `comparisonProperty` with the `comparisonValues` to run: the plan attaches the flow once per value.

```bash Synopsis theme={"theme":{"light":"everforest-light","dark":"everforest-dark"}}
roark simulation plan create [options]
```

> [!NOTE]
>
> Calls `POST /v1/simulation/plan`

## Request body

This endpoint accepts one of several request shapes, so the body is supplied as
JSON through `--data` or on standard input rather than as individual flags.

**CreateRunPlanFromConfig** `object`

Requires `name`, `direction`, `maxSimulationDurationSeconds`, `agentEndpoints`

**CreateRunPlanFromTemplate** `object`

Requires `template`, `agentEndpoints`, `direction`

## Example

```bash theme={"theme":{"light":"everforest-light","dark":"everforest-dark"}}
roark simulation plan create --data '{ ... }'
```

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.