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

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

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

Creates or updates a Deployment stack at the specified scope.

## Path parameters

- `deploymentStackName` string, required

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

## Request body

- DeploymentStack — unresolved $ref

## Response `200`

Resource 'DeploymentStack' update operation succeeded

- DeploymentStack — unresolved $ref

## Other responses

- `201` — Resource 'DeploymentStack' create operation succeeded
- `default` — An unexpected error response.

## Changes

- **2025-08-20** (2022-08-01-preview) `c35c8c573b02` — 2 info
  - api tag `DeploymentStacksAtSubscription` added
  - api tag `DeploymentStacks` removed
- **2025-06-04** (2022-08-01-preview) `46e0d627c40f` — 2 warning, 2 info
  - the optional response header `Azure-AsyncOperation` removed for the status `201`
  - the optional response header `Retry-After` removed for the status `201`
  - api tag `DeploymentStacks` added
  - api tag `DeploymentStacksAtSubscription` removed

[Change history](https://skmtc.dev/azure/apis/resources-microsoft-resources-deploymentstacks/changes/subscriptions/:subscriptionId/providers/Microsoft.Resources/deploymentStacks/:deploymentStackName/put.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)