> ## 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 group update

> Update a simulation group

Edits a saved simulation group. Omitted fields keep their current value; `notifications`, when sent, replaces the settings as a whole. Run groups it already started keep theirs. A group managed by config as code (`configManaged: true`) returns 409: change it in the config file.

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

> [!NOTE]
>
> Calls `PUT /v1/simulation/group/{groupId}`

## Arguments

**group-id** `string` *required*

The simulation group ID.

## Options

**--name** `string`

**--description** `string`

Send null to clear it.

**--simulation-run-plan-ids** `array`

Replaces the plans, in run order. Repeatable.

**--notifications** `object`

Where each run's group report announces itself once it is ready.

**--notifications.email** `object`

**--notifications.slack** `array`

Channels in the project's connected Slack workspace to post the report to (at most 10). Slack must be connected to the project first.

## Example

```bash theme={"theme":{"light":"everforest-light","dark":"everforest-dark"}}
roark simulation group update <group-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.