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

# astro deployment delete

> Delete a Deployment.

> [!NOTE]
>
> The behavior and format of this command differs depending on what Astronomer product you're using. Use the following tabs to change product contexts.

**Astro**

Delete a Deployment on Astro. This command is functionally identical to deleting a Deployment in the Astro UI.

When you run `astro deployment delete`, you are prompted to select from a list of Deployments that you can access in your Workspace. You can bypass this prompt and specify a Deployment name or ID in the command. To retrieve a Deployment ID, open your Deployment in the Astro UI and copy the value in the **ID** section of the Deployment page. You can also run `astro deployment list` to find a Deployment ID or name.

> [!NOTE]
>
> To complete this action, [Workspace Owner](https://astronomer.io/docs/astro/user-permissions.md#workspace-roles) permissions are required.

## Usage

```sh wrap theme={null}
astro deployment delete
```

## Options

| Option | Description | Possible Values |
| - | - | - |
| `<deployment-id>` | The ID of the Deployment to delete | Any valid Deployment ID |
| `-f`,`--force` | Do not include a confirmation prompt before deleting the Deployment | None |
| `--workspace-id` | Specify a Workspace to delete a Deployment outside of your current Workspace | Any valid Workspace ID |
| `--deployment-name` | The name of the Deployment to delete. Use as an alternative to `<deployment-id>`. | Any valid Deployment name |

## Examples

```sh wrap theme={null}
$ astro deployment delete
# CLI prompts you for a Deployment to delete
$ astro deployment delete ckvvfp9tf509941drl4vela81n -f
# Force delete a Deployment without a confirmation prompt
$ astro deployment delete --deployment-name="My deployment"
# Delete a Deployment by specifying its name.
```

**APC**

Delete a Deployment on Astro Private Cloud. This command is functionally identical to deleting a Deployment with the UI.

> [!NOTE]
>
> Astro Private Cloud now hard-deletes Deployments by default. The `-h`, `--hard` flag is deprecated because it has no effect, and Astronomer plans to remove it in a future release.

## Usage

```sh wrap theme={null}
astro deployment delete
```

## Options

| Option | Description | Possible Values |
| - | - | - |
| `<deployment-id>` (*Required*) | The ID of the Deployment to delete | Any valid Deployment ID |
| `-h`,`--hard` (*Deprecated*) | Previously deleted all infrastructure and records for this Deployment. No longer needed because hard delete is now the default. See [Hard delete a Deployment](https://www.astronomer.io/docs/software/configure-deployment#hard-delete-a-deployment) | None |

## Related commands

* [`astro deployment create`](https://astronomer.io/docs/cli/v1.47/astro-deployment-create)
* [`astro deployment list`](https://astronomer.io/docs/cli/v1.47/astro-deployment-list)