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

# appz remove

> Learn how to remove a deployment using the `appz remove` CLI command, which can also be abbreviated as `appz rm`. This command is used to delete deployments by ID or associated with a specific Appz Project.

export const GlobalOptionsComponent = ({command}) => <div>
    <h2><a href="#global-options">Global Options</a></h2>
    <p>These general options can be applied when using the <code>{command}</code> command:</p>
    <ul>
    <li><code>--cwd</code></li>
    <li><code>--debug</code></li>
    <li><code>--global-config</code></li>
    <li><code>--help</code></li>
    <li><code>--local-config</code></li>
    <li><code>--no-color</code></li>
    <li><code>--scope</code></li>
    <li><code>--token</code></li>
    </ul>

    <p>For detailed information on these global options and their applications, refer to the <a href="/cli/global-options">options section</a>.</p>
    </div>;

Deployments can also be removed from the Project Overview page on the Appz Dashboard.

## Usage

```bash terminal theme={null}
appz remove [deployment-url]
```

> Executing the `appz remove` command to delete a deployment from the Appz platform.

## Extended Usage

```bash terminal theme={null}
appz remove [deployment-url-1 deployment-url-2]
```

> Using the `appz remove` command to delete multiple deployments from the Appz platform.

```bash terminal theme={null}
appz remove [project-name]
```

> Using the `appz remove` command to delete all deployments for an Appz Project from the Appz platform.

Using the project name will result in the removal of the entire Appz Project from the current scope unless the `--safe` option is used.

## Unique Options

These options are specific to the appz remove command.

### Safe

The `--safe` option, abbreviated `-s`, allows you to omit the removal of deployments that have an active preview URL or production domain when a project name is specified.

```bash terminal theme={null}
appz remove my-project --safe
```

> Executing the appz remove command with the --safe option.

### Yes

The `--yes` option, shorthand `-y`, can be used to bypass the confirmation step for removing a deployment or Appz Project.

```bash terminal theme={null}
appz remove my-deployment.com --yes
```

> Using the appz remove command with the --yes option.

<GlobalOptionsComponent command={'appz rollback'} />
