> ## 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

<Info>The behavior and format of this command differs depending on what Astronomer product you're using. Use the following tabs to change product contexts.</Info>

<Tabs>
  <Tab title="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.

    <Info>To complete this action, [Workspace Owner](/docs/astro/user-permissions#workspace-roles) permissions are required.</Info>

    ## 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.
    ```
  </Tab>

  <Tab title="APC">
    Delete a Deployment on Astro Private Cloud. This command is functionally identical to deleting a Deployment with the UI.

    ## 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`                  | Deletes all infrastructure and records for this Deployment. See [Hard delete a Deployment](https://www.astronomer.io/docs/software/configure-deployment#hard-delete-a-deployment) | None                    |
  </Tab>
</Tabs>

## Related commands

* [`astro deployment create`](/docs/cli/v1.43/astro-deployment-create)
* [`astro deployment list`](/docs/cli/v1.43/astro-deployment-list)