---
title: "DELETE /subscriptions/{subscriptionId}/providers/Microsoft.Resources/deploymentStacks/{deploymentStackName}"
method: DELETE
path: "/subscriptions/{subscriptionId}/providers/Microsoft.Resources/deploymentStacks/{deploymentStackName}"
tags: ["DeploymentStacksAtSubscription"]
---

# DELETE /subscriptions/{subscriptionId}/providers/Microsoft.Resources/deploymentStacks/{deploymentStackName}

`DELETE /subscriptions/{subscriptionId}/providers/Microsoft.Resources/deploymentStacks/{deploymentStackName}`

Deletes a Deployment stack by name at the specified scope. When operation completes, status code 200 returned without content.

## Path parameters

- `deploymentStackName` string, required

## Query parameters

- `unmanageAction.Resources` 'delete' | 'detach'
- `unmanageAction.ResourceGroups` 'delete' | 'detach'
- `unmanageAction.ManagementGroups` 'delete' | 'detach'
- `unmanageAction.ResourcesWithoutDeleteSupport` 'detach' | 'fail'
- `bypassStackOutOfSyncError` boolean

## Parameters

- `../../../../../../common-types/resource-management/v6/types.json#/components/parameters/ApiVersionParameter` — unresolved $ref
- `../../../../../../common-types/resource-management/v6/types.json#/components/parameters/SubscriptionIdParameter` — unresolved $ref

## Response `200`

Resource deleted successfully.

## Other responses

- `202` — Resource deletion accepted.
- `204` — Resource does not exist.
- `default` — An unexpected error response.

## Changes

- **2026-07-13** (2022-08-01-preview) `0817df7a4e67` — 1 info
  - added the new optional `query` request parameter `unmanageAction.ResourcesWithoutDeleteSupport`
- **2026-07-13** (2022-08-01-preview) `f7437878802d` — 1 info
  - added the new optional `query` request parameter `bypassStackOutOfSyncError`
- **2025-08-20** (2022-08-01-preview) `c35c8c573b02` — 3 info
  - api tag `DeploymentStacksAtSubscription` added
  - api tag `DeploymentStacks` removed
  - added the new optional `query` request parameter `unmanageAction.ManagementGroups`
- **2025-06-04** (2022-08-01-preview) `46e0d627c40f` — 4 warning, 2 info
  - the optional response header `Retry-After` removed for the status `202`
  - deleted the `query` request parameter `bypassStackOutOfSyncError`
  - deleted the `query` request parameter `unmanageAction.ManagementGroups`
  - deleted the `query` request parameter `unmanageAction.ResourcesWithoutDeleteSupport`
  - …2 more

[Change history](https://skmtc.dev/azure/apis/resources-microsoft-resources-deploymentstacks/changes/subscriptions/:subscriptionId/providers/Microsoft.Resources/deploymentStacks/:deploymentStackName/delete.md)

---

[API](https://skmtc.dev/azure/apis/resources-microsoft-resources-deploymentstacks.md) · [All operations](https://skmtc.dev/azure/apis/resources-microsoft-resources-deploymentstacks/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/resources-microsoft-resources-deploymentstacks/revisions/0817df7a4e67/schema)