Skip to main content

astro deployment delete


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

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.


To complete this action, Workspace Owner permissions are required.


astro deployment delete


OptionDescriptionPossible Values
<deployment-id>The ID of the Deployment to deleteAny valid Deployment ID
-f,--forceDo not include a confirmation prompt before deleting the DeploymentNone
--workspace-idSpecify a Workspace to delete a Deployment outside of your current WorkspaceAny valid Workspace ID
--deployment-nameThe name of the Deployment to delete. Use as an alternative to <deployment-id>.Any valid Deployment name


$ 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.

Was this page helpful?

Sign up for Developer Updates

Get a summary of new Astro features once a month.

You can unsubscribe at any time.
By proceeding you agree to our Privacy Policy, our Website Terms and to receive emails from Astronomer.