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

# rig app-release rollback

> Restore app code and configuration; briefly restarts affected apps, not the workspace

Available **local and workspace**. Reference source: CLI `0.13.0-rc.5` (`824aefd6ad16`).

Use this command from your local terminal. Workspace-mode syntax, when available, is listed separately below. The workspace must already be running. If it is inactive, the command stops with a warning. Start it explicitly with `rig workspace start --workspace WORKSPACE_ID`, then submit the release action again.

## Examples

> [!WARNING]
>
> This command changes an existing resource or its configuration and may affect a running application. Confirm the target and review the complete help before running the example.

Run from your local terminal. Replace uppercase placeholders with your own values. This invocation performs the operation described above.

```bash theme={null}
rig app-release rollback --workspace WORKSPACE_ID --release RELEASE_ID
```

Inspect the supported arguments before running this command. Help is offline and does not modify resources.

```bash theme={null}
rig app-release rollback --help
```

## Local syntax

```text theme={null}
Usage: rigbox app-release rollback [OPTIONS] --workspace <WORKSPACE> --release <RELEASE>
```

### Arguments and flags

| Argument | Description | Details |
| - | - | - |
| `-w, --workspace` | Workspace name or ID | Required; Value: WORKSPACE |
| `--release` | Retained release from `rig app-release ls`; application data is not reverted Retained app release ID | Required; Value: RELEASE |
| `--output` | Output format \[default: human, or `rig config set output …`] | Global; Value: OUTPUT; Choices: human, json, yaml, text, table |
| `--query` | Filter output with a JMESPath expression | Global; Value: JMESPATH |
| `--cli-input-json` | Read inputs from a JSON file or '-' (stdin) | Global; Value: FILE |
| `--cli-input-yaml` | Read inputs from a YAML file or '-' (stdin) | Global; Value: FILE; Conflicts: cli\_input\_json |
| `--generate-cli-skeleton` | Print a fillable input template, then exit | Global; Default: false |
| `--no-pager` | Do not pipe help output through a pager | Global; Default: false |
| `-v, --verbose` | Verbose diagnostics on stderr: per-phase deploy tracing, job-poll status, and transport commands. Useful for debugging a slow or stuck `rig deploy` | Global; Default: false |
| `-h, --help` | Print help | |

> **Complete command help**
>
> ```text theme={null}
> Restore app code and configuration; briefly restarts affected apps, not the workspace
>
> Usage: rigbox app-release rollback [OPTIONS] --workspace <WORKSPACE> --release <RELEASE>
>
> Options:
>       --output <OUTPUT>
>           Output format [default: human, or `rig config set output …`]
>
>           [possible values: human, json, yaml, text, table]
>
>   -w, --workspace <WORKSPACE>
>           Workspace name or ID
>
>       --query <JMESPATH>
>           Filter output with a JMESPath expression
>
>       --release <RELEASE>
>           Retained release from `rig app-release ls`; application data is not reverted Retained app release ID
>
>       --cli-input-json <FILE>
>           Read inputs from a JSON file or '-' (stdin)
>
>       --cli-input-yaml <FILE>
>           Read inputs from a YAML file or '-' (stdin)
>
>       --generate-cli-skeleton
>           Print a fillable input template, then exit
>
>       --no-pager
>           Do not pipe help output through a pager
>
>   -v, --verbose
>           Verbose diagnostics on stderr: per-phase deploy tracing, job-poll status, and transport commands. Useful for debugging a slow or stuck `rig deploy`
>
>   -h, --help
>           Print help
> ```

## Workspace syntax

```text theme={null}
Usage: rigbox app-release rollback [OPTIONS] --workspace <WORKSPACE> --release <RELEASE>
```

### Arguments and flags

| Argument | Description | Details |
| - | - | - |
| `-w, --workspace` | Workspace name or ID | Required; Value: WORKSPACE |
| `--release` | Retained release from `rig app-release ls`; application data is not reverted Retained app release ID | Required; Value: RELEASE |
| `--output` | Output format \[default: human, or `rig config set output …`] | Global; Value: OUTPUT; Choices: human, json, yaml, text, table |
| `--query` | Filter output with a JMESPath expression | Global; Value: JMESPATH |
| `--no-pager` | Do not pipe help output through a pager | Global; Default: false |
| `-v, --verbose` | Verbose diagnostics on stderr (per-phase deploy tracing, job-poll status) | Global; Default: false |
| `-h, --help` | Print help | |

> **Complete command help**
>
> ```text theme={null}
> Restore app code and configuration; briefly restarts affected apps, not the workspace
>
> Usage: rigbox app-release rollback [OPTIONS] --workspace <WORKSPACE> --release <RELEASE>
>
> Options:
>       --output <OUTPUT>
>           Output format [default: human, or `rig config set output …`]
>
>           [possible values: human, json, yaml, text, table]
>
>   -w, --workspace <WORKSPACE>
>           Workspace name or ID
>
>       --query <JMESPATH>
>           Filter output with a JMESPath expression
>
>       --release <RELEASE>
>           Retained release from `rig app-release ls`; application data is not reverted Retained app release ID
>
>       --no-pager
>           Do not pipe help output through a pager
>
>   -v, --verbose
>           Verbose diagnostics on stderr (per-phase deploy tracing, job-poll status)
>
>   -h, --help
>           Print help
> ```


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