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

# modus scopes update

> Update a scope. Nested fields require --file/--body (see `scopes create --example`).

Update a scope. Nested fields require --file/--body (see `scopes create --example`).

## Usage

```bash theme={null}
modus scopes update [flags]
```

## Arguments

| Name |          | Description |
| ---- | -------- | ----------- |
| `id` | required | Scope id.   |

## Flags

| Flag            | Type   | Description                                      |
| --------------- | ------ | ------------------------------------------------ |
| `--file`        | string | Path to a JSON file with update fields.          |
| `--body`        | string | Read update fields as JSON from stdin ('-').     |
| `--name`        | string | Scope display name.                              |
| `--description` | string | One-paragraph description.                       |
| `--model`       | string | Model identifier (e.g. claude-sonnet-5).         |
| `--instruction` | string | System-prompt instruction fragment (repeatable). |
| `--guardrail`   | string | Guardrail id (repeatable).                       |

Global: `--pretty` — human-readable table output instead of compact JSON.

See [CLI quickstart](/guides/cli) for install and auth.