# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Microsoft Azure DeploymentStacksClient Deployment Stacks API
  version: 1.0.0
extends: openapi/microsoft-azure-deploymentstacks-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 15
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Resources/deploymentStacks'].get
  update:
    x-apievangelist-phrasing:
      intent: List deployment stacks in a resource group
      effect: read
      questions:
      - Which deployment stacks are deployed into my resource group?
      - Can I see the resource-group-scoped deployment stacks only?
      instructions:
      - text: List the deployment stacks in my resource group.
      - text: Show every resource-group-level deployment stack.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Resources/deploymentStacks'].get
  update:
    x-apievangelist-phrasing:
      intent: List deployment stacks in a subscription
      effect: read
      questions:
      - What deployment stacks have been created at subscription scope?
      - How do I enumerate the subscription-level deployment stacks in Azure?
      instructions:
      - text: List the deployment stacks at subscription scope.
      - text: Show all subscription-wide deployment stacks I own.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.Management/managementGroups/{managementGroupId}/providers/Microsoft.Resources/deploymentStacks'].get
  update:
    x-apievangelist-phrasing:
      intent: List deployment stacks in a management group
      effect: read
      questions:
      - Which deployment stacks are defined on a management group?
      - Can I list stacks created at management group scope?
      instructions:
      - text: List the deployment stacks in management group {mg}.
        slots:
          mg: path.managementGroupId
      - text: Show every stack deployed at the {mg} management group.
        slots:
          mg: path.managementGroupId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Resources/deploymentStacks/{deploymentStackName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a resource group deployment stack
      effect: read
      questions:
      - How do I see the managed resources and status of a stack in my resource group?
      - What deny settings are applied to a resource-group deployment stack?
      instructions:
      - text: Get deployment stack {stack} in my resource group.
        slots:
          stack: path.deploymentStackName
      - text: Show the resource-group-scoped stack named {stack}.
        slots:
          stack: path.deploymentStackName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Resources/deploymentStacks/{deploymentStackName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a resource group deployment stack
      effect: write
      questions:
      - How do I deploy a template as a stack into a single resource group?
      - Can I redeploy an existing resource-group stack with a new template?
      instructions:
      - text: Create deployment stack {stack} in my resource group with properties {properties}.
        slots:
          stack: path.deploymentStackName
          properties: requestBody.properties
      - text: Update the resource-group-level stack {stack}.
        slots:
          stack: path.deploymentStackName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Resources/deploymentStacks/{deploymentStackName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a resource group deployment stack
      effect: destructive
      questions:
      - When I delete a resource-group stack, can I keep or delete the resources it manages?
      - How do I remove a deployment stack from my resource group?
      instructions:
      - text: Delete deployment stack {stack} from my resource group.
        slots:
          stack: path.deploymentStackName
      - text: Delete the resource-group stack {stack} and set resources to {action}.
        slots:
          stack: path.deploymentStackName
          action: query.unmanageAction.Resources
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Resources/deploymentStacks/{deploymentStackName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a subscription deployment stack
      effect: read
      questions:
      - How do I read the details of a stack deployed at subscription scope?
      - Which resources does a subscription-level deployment stack manage?
      instructions:
      - text: Get subscription-scoped deployment stack {stack}.
        slots:
          stack: path.deploymentStackName
      - text: Show the subscription-level stack called {stack}.
        slots:
          stack: path.deploymentStackName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Resources/deploymentStacks/{deploymentStackName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a subscription deployment stack
      effect: write
      questions:
      - How do I create a deployment stack that spans my whole subscription?
      - Can a subscription-scope stack be given a location and tags?
      instructions:
      - text: Create subscription-scoped deployment stack {stack} in location {location}.
        slots:
          stack: path.deploymentStackName
          location: requestBody.location
      - text: Redeploy the subscription-level stack {stack} with properties {properties}.
        slots:
          stack: path.deploymentStackName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Resources/deploymentStacks/{deploymentStackName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a subscription deployment stack
      effect: destructive
      questions:
      - How do I remove a stack deployed at subscription scope?
      - Can I detach resource groups instead of deleting them when removing a subscription stack?
      instructions:
      - text: Delete subscription-scoped deployment stack {stack}.
        slots:
          stack: path.deploymentStackName
      - text: Remove the subscription-level stack {stack} and set resource groups to {action}.
        slots:
          stack: path.deploymentStackName
          action: query.unmanageAction.ResourceGroups
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.Management/managementGroups/{managementGroupId}/providers/Microsoft.Resources/deploymentStacks/{deploymentStackName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a management group deployment stack
      effect: read
      questions:
      - How do I inspect a deployment stack that lives on a management group?
      - What is the provisioning state of a management-group-scope stack?
      instructions:
      - text: Get deployment stack {stack} in management group {mg}.
        slots:
          stack: path.deploymentStackName
          mg: path.managementGroupId
      - text: Show the {mg} management group's stack named {stack}.
        slots:
          stack: path.deploymentStackName
          mg: path.managementGroupId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.Management/managementGroups/{managementGroupId}/providers/Microsoft.Resources/deploymentStacks/{deploymentStackName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a management group deployment stack
      effect: write
      questions:
      - How do I deploy a stack across a management group?
      - Can I update a management-group stack's template and deny settings?
      instructions:
      - text: Create deployment stack {stack} in management group {mg} in location {location}.
        slots:
          stack: path.deploymentStackName
          mg: path.managementGroupId
          location: requestBody.location
      - text: Redeploy stack {stack} on management group {mg} with properties {properties}.
        slots:
          stack: path.deploymentStackName
          mg: path.managementGroupId
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.Management/managementGroups/{managementGroupId}/providers/Microsoft.Resources/deploymentStacks/{deploymentStackName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a management group deployment stack
      effect: destructive
      questions:
      - How do I remove a stack deployed at management group scope?
      - Can I choose to detach child management groups when deleting a management-group stack?
      instructions:
      - text: Delete deployment stack {stack} from management group {mg}.
        slots:
          stack: path.deploymentStackName
          mg: path.managementGroupId
      - text: Remove stack {stack} on management group {mg} and set child management groups to {action}.
        slots:
          stack: path.deploymentStackName
          mg: path.managementGroupId
          action: query.unmanageAction.ManagementGroups
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Resources/deploymentStacks/{deploymentStackName}/exportTemplate'].post
  update:
    x-apievangelist-phrasing:
      intent: Export a resource group stack's template
      effect: read
      questions:
      - How do I get back the template that created a stack in my resource group?
      - Can I download the ARM template behind a resource-group deployment stack?
      instructions:
      - text: Export the template of resource-group deployment stack {stack}.
        slots:
          stack: path.deploymentStackName
      - text: Download the ARM template used by stack {stack} in my resource group.
        slots:
          stack: path.deploymentStackName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Resources/deploymentStacks/{deploymentStackName}/exportTemplate'].post
  update:
    x-apievangelist-phrasing:
      intent: Export a subscription stack's template
      effect: read
      questions:
      - How do I retrieve the template for a subscription-level deployment stack?
      - Where can I get the source template of a stack deployed to my subscription?
      instructions:
      - text: Export the template of subscription-scoped stack {stack}.
        slots:
          stack: path.deploymentStackName
      - text: Fetch the ARM template behind the subscription stack {stack}.
        slots:
          stack: path.deploymentStackName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.Management/managementGroups/{managementGroupId}/providers/Microsoft.Resources/deploymentStacks/{deploymentStackName}/exportTemplate'].post
  update:
    x-apievangelist-phrasing:
      intent: Export a management group stack's template
      effect: read
      questions:
      - How do I export the template of a stack on a management group?
      - Can I recover the template used for a management-group deployment stack?
      instructions:
      - text: Export the template of stack {stack} in management group {mg}.
        slots:
          stack: path.deploymentStackName
          mg: path.managementGroupId
      - text: Fetch the ARM template behind management group {mg}'s stack {stack}.
        slots:
          stack: path.deploymentStackName
          mg: path.managementGroupId
      method: generated
      generated: '2026-09-26'