> ## 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 recipe app delete

> Delete published recipe version(s)

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.

## Examples

> [!WARNING]
>
> This command deletes a resource. Confirm the identifier and preserve any data you need 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 recipe app delete --ref DEPLOY_REF
```

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

```bash theme={null}
rig recipe app delete --help
```

## Local syntax

```text theme={null}
Usage: rigbox recipe app delete [OPTIONS] --ref <DEPLOY_REF>
```

### Arguments and flags

| Argument | Description | Details |
| - | - | - |
| `-r, --ref` | Recipe ref. With a version (@vendor/slug\@version) deletes that one version; with --all-versions pass the version-less @vendor/slug | Required; Value: DEPLOY\_REF |
| `--all-versions` | Delete every published version of the recipe. The ref must NOT carry a version when this is set | Default: false |
| `--force` | Skip the confirmation prompt | Default: false |
| `--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}
> Delete published recipe version(s)
>
> Usage: rigbox recipe app delete [OPTIONS] --ref <DEPLOY_REF>
>
> Options:
>       --output <OUTPUT>
>           Output format [default: human, or `rig config set output …`]
>
>           [possible values: human, json, yaml, text, table]
>
>   -r, --ref <DEPLOY_REF>
>           Recipe ref. With a version (@vendor/slug@version) deletes that one version; with --all-versions pass the version-less @vendor/slug
>
>       --all-versions
>           Delete every published version of the recipe. The ref must NOT carry a version when this is set
>
>       --query <JMESPATH>
>           Filter output with a JMESPath expression
>
>       --cli-input-json <FILE>
>           Read inputs from a JSON file or '-' (stdin)
>
>       --force
>           Skip the confirmation prompt
>
>       --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 recipe app delete [OPTIONS] --ref <DEPLOY_REF>
```

### Arguments and flags

| Argument | Description | Details |
| - | - | - |
| `-r, --ref` | Recipe ref. With a version (@vendor/slug\@version) deletes that one version; with --all-versions pass the version-less @vendor/slug | Required; Value: DEPLOY\_REF |
| `--all-versions` | Delete every published version of the recipe. The ref must NOT carry a version when this is set | Default: false |
| `--force` | Skip the confirmation prompt | Default: false |
| `--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}
> Delete published recipe version(s)
>
> Usage: rigbox recipe app delete [OPTIONS] --ref <DEPLOY_REF>
>
> Options:
>       --output <OUTPUT>
>           Output format [default: human, or `rig config set output …`]
>
>           [possible values: human, json, yaml, text, table]
>
>   -r, --ref <DEPLOY_REF>
>           Recipe ref. With a version (@vendor/slug@version) deletes that one version; with --all-versions pass the version-less @vendor/slug
>
>       --all-versions
>           Delete every published version of the recipe. The ref must NOT carry a version when this is set
>
>       --query <JMESPATH>
>           Filter output with a JMESPath expression
>
>       --force
>           Skip the confirmation prompt
>
>       --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.