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

> Update an environment

Updates one of the project's environments. Only the fields sent are changed. Runs already built keep the snapshot they were built with. Roark-curated environments cannot be edited (403).

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

> [!NOTE]
>
> Calls `PUT /v1/simulation/environment/{environmentId}`

## Arguments

**environment-id** `string` *required*

The environment-id.

## Options

**--name** `string`

Display name, shown wherever a flow variant references the environment.

**--description** `string`

Optional note on when to use this environment.

**--background-noise** `string`

The noise bed played underneath the simulated caller. NONE plays nothing. One of `NONE`, `AIRPORT`, `CHILDREN_PLAYING`, `CITY`, `COFFEE_SHOP`, `CONSTRUCTION`, `CRYING_BABY`, `DRIVING`, `LIBRARY`, `OFFICE`, `THUNDERSTORM`, `TRAIN`

**--background-noise-volume** `number`

How loud the bed plays, as a gain from 0 (silent) to 1 (as loud as the caller). Defaults to 0.1, which sits well under the caller. Ignored on Vapi endpoints, which have no level control.

## Example

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