This is the AWS CDK v2 Developer Guide. The older CDK v1 entered maintenance on June 1, 2022 and ended support on June 1, 2023.

# `cdk destroy`
<a name="ref-cli-cmd-destroy"></a>

Delete one or more AWS CDK stacks from your AWS environment.

When you delete a stack, resources in the stack will be destroyed, unless they were configured with a `DeletionPolicy` of `Retain`.

During stack deletion, this command will output progress information similar to `cdk deploy` behavior.

## Usage
<a name="ref-cli-cmd-destroy-usage"></a>

```
$ cdk destroy <arguments> <options>
```

## Arguments
<a name="ref-cli-cmd-destroy-args"></a><a name="ref-cli-cmd-destroy-args-stack-name"></a>

 **CDK stack ID**   
The construct ID of the CDK stack from your app to delete.  
 *Type*: String  
 *Required*: No

## Options
<a name="ref-cli-cmd-destroy-options"></a>

For a list of global options that work with all CDK CLI commands, see [Global options](ref-cli-cmd.md#ref-cli-cmd-options).<a name="ref-cli-cmd-destroy-options-all"></a>

 `--all <BOOLEAN>`   
Destroy all available stacks.  
 *Default value*: `false` <a name="ref-cli-cmd-destroy-options-concurrency"></a>

 `--concurrency <NUMBER>`   
Destroy multiple stacks in parallel while accounting for inter-stack dependencies. Use this option to speed up destroy operations. You must still factor in AWS CloudFormation and other AWS account rate limiting.  
Provide a number to specify the maximum number of simultaneous destroy operations (dependency permitting) to perform.  
 *Default value*: `1` <a name="ref-cli-cmd-destroy-options-exclusively"></a>

 `--exclusively, -e <BOOLEAN>`   
Only destroy requested stacks and don’t include dependencies.<a name="ref-cli-cmd-destroy-options-force"></a>

 `--force, -f <BOOLEAN>`   
Do not ask for confirmation before destroying the stacks.<a name="ref-cli-cmd-destroy-options-help"></a>

 `--help, -h <BOOLEAN>`   
Show command reference information for the `cdk destroy` command.

## Examples
<a name="ref-cli-cmd-destroy-examples"></a>

### Delete a stack named MyStackName
<a name="ref-cli-cmd-destroy-examples-1"></a>

```
$ cdk destroy --app='node bin/main.js' <MyStackName>
```

### Delete multiple stacks in parallel
<a name="ref-cli-cmd-destroy-examples-2"></a>

Use the `--concurrency` option with `--all` to delete all stacks in parallel:

```
$ cdk destroy --all --concurrency 5
```