# 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 WebSite Management Client Sites API
  version: 1.0.0
extends: openapi/microsoft-azure-sites-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 161
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/virtualNetworkConnections/{vnetName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a slot's virtual network connection
      effect: read
      questions:
      - Which settings does a staging slot's link to a specific VNet have?
      - Can I look up one virtual network connection on a deployment slot rather than the production app?
      instructions:
      - text: Show VNet connection {vnet} on non-production slot {slot} of app {app} in {rg} (subscription {sub}).
        slots:
          vnet: path.vnetName
          slot: path.slot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Fetch the details of the {vnet} network link for deployment slot {slot} of {app}.
        slots:
          vnet: path.vnetName
          slot: path.slot
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/virtualNetworkConnections/{vnetName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Add or replace a slot's VNet connection
      effect: write
      questions:
      - How do I attach a deployment slot to an Azure virtual network?
      - Can a staging slot get its own VNet connection, separate from production?
      instructions:
      - text: Connect non-production slot {slot} of app {app} in {rg} (subscription {sub}) to virtual network {vnet} in {location}.
        slots:
          slot: path.slot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
          vnet: path.vnetName
          location: requestBody.location
      - text: Create or overwrite the {vnet} VNet link on deployment slot {slot} of {app}.
        slots:
          vnet: path.vnetName
          slot: path.slot
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/virtualNetworkConnections/{vnetName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a slot's VNet connection
      effect: destructive
      questions:
      - How can I disconnect a deployment slot from a virtual network?
      - What happens to a staging slot when I drop its VNet association?
      instructions:
      - text: Remove virtual network {vnet} from non-production slot {slot} of app {app} in {rg} (subscription {sub}).
        slots:
          vnet: path.vnetName
          slot: path.slot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Detach deployment slot {slot} of {app} from the {vnet} network.
        slots:
          slot: path.slot
          app: path.name
          vnet: path.vnetName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/virtualNetworkConnections/{vnetName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Patch a slot's VNet connection
      effect: write
      questions:
      - Can I change just some properties of a deployment slot's existing VNet link?
      - Is there a partial update for a staging slot's virtual network connection?
      instructions:
      - text: Patch the existing {vnet} connection on non-production slot {slot} of app {app} in {rg} (subscription {sub}), location {location}.
        slots:
          vnet: path.vnetName
          slot: path.slot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
          location: requestBody.location
      - text: Partially update VNet link {vnet} already on deployment slot {slot} of {app}.
        slots:
          vnet: path.vnetName
          slot: path.slot
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/virtualNetworkConnections/{vnetName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a web app's virtual network connection
      effect: read
      questions:
      - How do I see how my production web app is linked to one particular VNet?
      - What does the virtual network connection on my main App Service app look like?
      instructions:
      - text: Show the VNet connection {vnet} on web app {app} in {rg} (subscription {sub}).
        slots:
          vnet: path.vnetName
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Get details of production app {app}'s link to virtual network {vnet}.
        slots:
          app: path.name
          vnet: path.vnetName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/virtualNetworkConnections/{vnetName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Connect a web app to a virtual network
      effect: write
      questions:
      - Can I put my production web app on an Azure virtual network through the API?
      - How is a VNet integration added to the main app, not a slot?
      instructions:
      - text: Connect web app {app} in {rg} (subscription {sub}) to virtual network {vnet} in {location}.
        slots:
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
          vnet: path.vnetName
          location: requestBody.location
      - text: Create or replace production app {app}'s integration with VNet {vnet}.
        slots:
          app: path.name
          vnet: path.vnetName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/virtualNetworkConnections/{vnetName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Disconnect a web app from a virtual network
      effect: destructive
      questions:
      - How do I remove VNet integration from my production web app?
      - Will my main app lose access to private resources if I delete its virtual network link?
      instructions:
      - text: Disconnect web app {app} in {rg} (subscription {sub}) from virtual network {vnet}.
        slots:
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
          vnet: path.vnetName
      - text: Delete production app {app}'s association with the {vnet} network.
        slots:
          app: path.name
          vnet: path.vnetName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/virtualNetworkConnections/{vnetName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Patch a web app's VNet connection
      effect: write
      questions:
      - Can I modify a few fields on my production app's existing VNet link without replacing it?
      - Which call partially updates the main web app's virtual network connection?
      instructions:
      - text: Patch the {vnet} network connection already on web app {app} in {rg} (subscription {sub}), location {location}.
        slots:
          vnet: path.vnetName
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
          location: requestBody.location
      - text: Partially update production app {app}'s existing link to VNet {vnet}.
        slots:
          app: path.name
          vnet: path.vnetName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/networkFeatures/{view}'].get
  update:
    x-apievangelist-phrasing:
      intent: View network features used by a slot
      effect: read
      questions:
      - Which network features, like VNet or hybrid connections, is my staging slot using?
      - Can I get a summary or detailed view of networking on a deployment slot?
      instructions:
      - text: Show the {view} network features view for non-production slot {slot} of app {app} in {rg} (subscription {sub}).
        slots:
          view: path.view
          slot: path.slot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: List networking features in use on deployment slot {slot} of {app} as a {view} view.
        slots:
          slot: path.slot
          app: path.name
          view: path.view
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/networkFeatures/{view}'].get
  update:
    x-apievangelist-phrasing:
      intent: View network features used by a web app
      effect: read
      questions:
      - What network features is my production web app currently using?
      - Is there a summary versus detailed networking view for the main app?
      instructions:
      - text: Show the {view} network features view for web app {app} in {rg} (subscription {sub}).
        slots:
          view: path.view
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Report which networking features production app {app} uses, {view} view.
        slots:
          app: path.name
          view: path.view
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/operationresults/{operationId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check a slot's async operation result
      effect: read
      questions:
      - How can I check the result of a long-running operation on a deployment slot?
      - Did the async operation I started on my staging slot finish?
      instructions:
      - text: Get the result of operation {operation} on non-production slot {slot} of app {app} in {rg} (subscription {sub}).
        slots:
          operation: path.operationId
          slot: path.slot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Check status of async operation {operation} for deployment slot {slot} of {app}.
        slots:
          operation: path.operationId
          slot: path.slot
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/operationresults/{operationId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check a web app's async operation result
      effect: read
      questions:
      - Where do I poll for the outcome of a long-running operation on my web app?
      - Has operation I kicked off against my production app completed yet?
      instructions:
      - text: Get the result of operation {operation} on web app {app} in {rg} (subscription {sub}).
        slots:
          operation: path.operationId
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Poll async operation {operation} for production app {app}.
        slots:
          operation: path.operationId
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slotsswap'].post
  update:
    x-apievangelist-phrasing:
      intent: Swap a slot into production
      effect: write
      questions:
      - How do I swap my staging slot into production for a web app?
      - Can I keep the virtual network on the production side when swapping slots?
      instructions:
      - text: Swap slot {target_slot} into production for web app {app} in {rg} (subscription {sub}).
        slots:
          target_slot: requestBody.targetSlot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: 'Promote deployment slot {target_slot} of {app} to production, preserving VNet: {preserve_vnet}.'
        slots:
          target_slot: requestBody.targetSlot
          app: path.name
          preserve_vnet: requestBody.preserveVnet
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/slotsswap'].post
  update:
    x-apievangelist-phrasing:
      intent: Swap two non-production slots
      effect: write
      questions:
      - Can I swap two deployment slots with each other instead of with production?
      - Is it possible to exchange a test slot and a staging slot directly?
      instructions:
      - text: Swap slot {slot} with slot {target_slot} on app {app} in {rg} (subscription {sub}).
        slots:
          slot: path.slot
          target_slot: requestBody.targetSlot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Exchange the contents of deployment slots {slot} and {target_slot} for {app}.
        slots:
          slot: path.slot
          target_slot: requestBody.targetSlot
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slotsdiffs'].post
  update:
    x-apievangelist-phrasing:
      intent: Compare a slot's settings with production
      effect: read
      questions:
      - What configuration settings differ between production and my staging slot before a swap?
      - Can I preview which app settings would change if I swapped a slot into production?
      instructions:
      - text: Compare production settings of web app {app} in {rg} (subscription {sub}) against slot {target_slot}.
        slots:
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
          target_slot: requestBody.targetSlot
      - text: List config differences between production {app} and deployment slot {target_slot}.
        slots:
          app: path.name
          target_slot: requestBody.targetSlot
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/slotsdiffs'].post
  update:
    x-apievangelist-phrasing:
      intent: Compare settings between two slots
      effect: read
      questions:
      - Which configuration values differ between two of my non-production slots?
      - Can I diff a test slot's config against another slot rather than production?
      instructions:
      - text: Compare the settings of slot {slot} with slot {target_slot} on app {app} in {rg} (subscription {sub}).
        slots:
          slot: path.slot
          target_slot: requestBody.targetSlot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show config differences between deployment slots {slot} and {target_slot} of {app}.
        slots:
          slot: path.slot
          target_slot: requestBody.targetSlot
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/applySlotConfig'].post
  update:
    x-apievangelist-phrasing:
      intent: Apply a slot's settings to production
      effect: write
      questions:
      - How do I apply the target slot's configuration to production before completing a swap?
      - Can I stage a swap by copying slot config onto the production app first?
      instructions:
      - text: Apply the config of slot {target_slot} onto production for web app {app} in {rg} (subscription {sub}).
        slots:
          target_slot: requestBody.targetSlot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Start a swap-with-preview by applying slot {target_slot} settings to production {app}.
        slots:
          target_slot: requestBody.targetSlot
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/applySlotConfig'].post
  update:
    x-apievangelist-phrasing:
      intent: Apply one slot's settings to another slot
      effect: write
      questions:
      - Can I apply one deployment slot's configuration onto a different slot?
      - What's the first step of a swap preview between two non-production slots?
      instructions:
      - text: Apply the settings of slot {target_slot} onto non-production slot {slot} of app {app} in {rg} (subscription {sub}).
        slots:
          target_slot: requestBody.targetSlot
          slot: path.slot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Copy configuration from deployment slot {target_slot} onto slot {slot} of {app} for a preview swap.
        slots:
          target_slot: requestBody.targetSlot
          slot: path.slot
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/resetSlotConfig'].post
  update:
    x-apievangelist-phrasing:
      intent: Undo applied slot config on production
      effect: write
      questions:
      - How do I cancel a swap preview and revert production's configuration?
      - Can I roll back settings that were applied to production from another slot?
      instructions:
      - text: Reset production configuration of web app {app} in {rg} (subscription {sub}) after a swap preview.
        slots:
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Revert the slot config previously applied to production app {app}.
        slots:
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/resetSlotConfig'].post
  update:
    x-apievangelist-phrasing:
      intent: Undo applied config on a slot
      effect: write
      questions:
      - Can I revert a deployment slot's settings after applying another slot's config to it?
      - How is a swap preview cancelled on a non-production slot?
      instructions:
      - text: Reset the configuration of slot {slot} on app {app} in {rg} (subscription {sub}).
        slots:
          slot: path.slot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Revert the config applied to deployment slot {slot} of {app} during a preview swap.
        slots:
          slot: path.slot
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/config/slotConfigNames'].get
  update:
    x-apievangelist-phrasing:
      intent: List slot-sticky setting names
      effect: read
      questions:
      - Which app settings and connection strings stay with the slot when I swap?
      - How can I see which settings are marked as slot-sticky on my web app?
      instructions:
      - text: List the sticky app setting and connection string names for web app {app} in {rg} (subscription {sub}).
        slots:
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show which settings of {app} remain with their slot during a swap.
        slots:
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/config/slotConfigNames'].put
  update:
    x-apievangelist-phrasing:
      intent: Set which settings stick to a slot
      effect: write
      questions:
      - How do I mark an app setting so it doesn't move during a slot swap?
      - Can I change the list of connection strings that remain with each slot?
      instructions:
      - text: Update the slot-sticky setting names for web app {app} in {rg} (subscription {sub}), location {location}.
        slots:
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
          location: requestBody.location
      - text: Mark which app settings and connection strings of {app} stay put on swap.
        slots:
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots'].get
  update:
    x-apievangelist-phrasing:
      intent: List a web app's deployment slots
      effect: read
      questions:
      - What deployment slots does my web app have?
      - Can I include extra properties when listing an app's slots?
      instructions:
      - text: List all deployment slots of web app {app} in {rg} (subscription {sub}).
        slots:
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show the slots for {app} including properties {properties}.
        slots:
          app: path.name
          properties: query.propertiesToInclude
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites'].get
  update:
    x-apievangelist-phrasing:
      intent: List web apps in a resource group
      effect: read
      questions:
      - Which web apps are in a given resource group?
      - Can I include deployment slots or limit app types when listing sites in a resource group?
      instructions:
      - text: List the web apps in resource group {rg} (subscription {sub}).
        slots:
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: 'Show all sites in {rg} (subscription {sub}) with slots included: {include_slots}.'
        slots:
          rg: path.resourceGroupName
          sub: path.subscriptionId
          include_slots: query.includeSlots
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a web app's details
      effect: read
      questions:
      - How do I look up the details of one App Service web app?
      - What state, host names and plan does my production web app report?
      instructions:
      - text: Get details of web app {app} in {rg} (subscription {sub}).
        slots:
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show production app {app} with extra properties {properties}.
        slots:
          app: path.name
          properties: query.propertiesToInclude
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or modify a web app
      effect: write
      questions:
      - How do I create a new App Service web app through the API?
      - Can I skip DNS registration or custom domain verification when creating a site?
      instructions:
      - text: Create web app {app} in resource group {rg} (subscription {sub}) in {location}.
        slots:
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
          location: requestBody.location
      - text: 'Create or update production app {app} in {rg} (subscription {sub}), skipping DNS registration: {skip_dns}.'
        slots:
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
          skip_dns: query.skipDnsRegistration
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a web app
      effect: destructive
      questions:
      - How do I delete a web app, and can its empty App Service plan be removed too?
      - Does deleting a site also delete all of its deployment slots?
      instructions:
      - text: Delete web app {app} in resource group {rg} (subscription {sub}).
        slots:
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: 'Delete {app} in {rg} (subscription {sub}) along with all its slots: {delete_all_slots}.'
        slots:
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
          delete_all_slots: query.deleteAllSlots
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a deployment slot's details
      effect: read
      questions:
      - How can I see the details of a single deployment slot?
      - What state and host names does my staging slot report?
      instructions:
      - text: Get details of non-production slot {slot} of web app {app} in {rg} (subscription {sub}).
        slots:
          slot: path.slot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show deployment slot {slot} of {app} with properties {properties}.
        slots:
          slot: path.slot
          app: path.name
          properties: query.propertiesToInclude
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or modify a deployment slot
      effect: write
      questions:
      - How do I add a new staging slot to my web app?
      - Can I create a deployment slot without verifying its custom domain?
      instructions:
      - text: Create deployment slot {slot} for web app {app} in {rg} (subscription {sub}) in {location}.
        slots:
          slot: path.slot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
          location: requestBody.location
      - text: 'Create or update slot {slot} of {app}, skipping custom domain verification: {skip_domain}.'
        slots:
          slot: path.slot
          app: path.name
          skip_domain: query.skipCustomDomainVerification
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a deployment slot
      effect: destructive
      questions:
      - How do I remove a staging slot I no longer use?
      - Can I also delete the slot's metrics when removing it?
      instructions:
      - text: Delete the whole deployment slot {slot} of web app {app} in {rg} (subscription {sub}).
        slots:
          slot: path.slot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: 'Remove slot {slot} from {app} and delete its metrics: {delete_metrics}.'
        slots:
          slot: path.slot
          app: path.name
          delete_metrics: query.deleteMetrics
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/iscloneable'].post
  update:
    x-apievangelist-phrasing:
      intent: Check whether a web app can be cloned
      effect: read
      questions:
      - Can my production web app be cloned?
      - Is there a way to test if a site is eligible for cloning before I try?
      instructions:
      - text: Check whether web app {app} in {rg} (subscription {sub}) is cloneable.
        slots:
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Tell me if production app {app} can be cloned.
        slots:
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/iscloneable'].post
  update:
    x-apievangelist-phrasing:
      intent: Check whether a slot can be cloned
      effect: read
      questions:
      - Is my staging slot eligible to be cloned?
      - Can I verify a deployment slot supports cloning before copying it?
      instructions:
      - text: Check whether non-production slot {slot} of web app {app} in {rg} (subscription {sub}) is cloneable.
        slots:
          slot: path.slot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Tell me if deployment slot {slot} of {app} can be cloned.
        slots:
          slot: path.slot
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/recover'].post
  update:
    x-apievangelist-phrasing:
      intent: Recover a deleted web app
      effect: write
      questions:
      - How do I bring back a web app I deleted?
      - Can I recover a site to a snapshot time and restore its configuration too?
      instructions:
      - text: Recover web app {app} in {rg} (subscription {sub}) from snapshot time {snapshot_time}.
        slots:
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
          snapshot_time: requestBody.snapshotTime
      - text: 'Restore deleted app {app} into site {site_name}, recovering config: {recover_config}.'
        slots:
          app: path.name
          site_name: requestBody.siteName
          recover_config: requestBody.recoverConfig
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/recover'].post
  update:
    x-apievangelist-phrasing:
      intent: Recover a deleted deployment slot
      effect: write
      questions:
      - Can a deleted deployment slot be recovered?
      - How would I restore a staging slot to an earlier snapshot into a different slot?
      instructions:
      - text: Recover non-production slot {slot} of web app {app} in {rg} (subscription {sub}) from snapshot {snapshot_time}.
        slots:
          slot: path.slot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
          snapshot_time: requestBody.snapshotTime
      - text: Restore deployment slot {slot} of {app} into slot {slot_name}.
        slots:
          slot: path.slot
          app: path.name
          slot_name: requestBody.slotName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/snapshots'].put
  update:
    x-apievangelist-phrasing:
      intent: List a web app's snapshots
      effect: read
      questions:
      - What snapshots exist for my production web app?
      - Where can I find the point-in-time snapshots I could recover the main app from?
      instructions:
      - text: List the snapshots for web app {app} in {rg} (subscription {sub}).
        slots:
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show available recovery snapshots of production app {app}.
        slots:
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/snapshots'].put
  update:
    x-apievangelist-phrasing:
      intent: List a deployment slot's snapshots
      effect: read
      questions:
      - Which snapshots are available for a deployment slot?
      - Can I see point-in-time snapshots of my staging slot?
      instructions:
      - text: List the snapshots for non-production slot {slot} of web app {app} in {rg} (subscription {sub}).
        slots:
          slot: path.slot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show recovery snapshots of deployment slot {slot} of {app}.
        slots:
          slot: path.slot
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/deletedSites'].get
  update:
    x-apievangelist-phrasing:
      intent: List deleted web apps in a resource group
      effect: read
      questions:
      - Which web apps were deleted from a resource group and could be recovered?
      - Can I see recently removed sites filtered by app type?
      instructions:
      - text: List deleted web apps in resource group {rg} (subscription {sub}).
        slots:
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show deleted sites in {rg} (subscription {sub}) of types {site_types}.
        slots:
          rg: path.resourceGroupName
          sub: path.subscriptionId
          site_types: query.includeSiteTypes
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/deployments'].get
  update:
    x-apievangelist-phrasing:
      intent: List a web app's deployments
      effect: read
      questions:
      - What deployments have been made to my production web app?
      - Where do I see the deployment history of the main app?
      instructions:
      - text: List deployments of web app {app} in {rg} (subscription {sub}).
        slots:
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show the deployment history for production app {app}.
        slots:
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/deployments'].get
  update:
    x-apievangelist-phrasing:
      intent: List a deployment slot's deployments
      effect: read
      questions:
      - What has been deployed to my staging slot?
      - Can I get the deployment history for a single slot?
      instructions:
      - text: List deployments of non-production slot {slot} of web app {app} in {rg} (subscription {sub}).
        slots:
          slot: path.slot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show the deployment history for deployment slot {slot} of {app}.
        slots:
          slot: path.slot
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/instances/{instanceId}/deployments'].get
  update:
    x-apievangelist-phrasing:
      intent: List deployments on one app instance
      effect: read
      questions:
      - Which deployments ran on a specific instance of my web app?
      - Can I see deployment history per scaled-out instance?
      instructions:
      - text: List deployments on instance {instance} of web app {app} in {rg} (subscription {sub}).
        slots:
          instance: path.instanceId
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show what was deployed to production instance {instance} of {app}.
        slots:
          instance: path.instanceId
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/instances/{instanceId}/deployments'].get
  update:
    x-apievangelist-phrasing:
      intent: List deployments on a slot instance
      effect: read
      questions:
      - What deployments ran on one instance of a deployment slot?
      - Can I break down a staging slot's deployments by instance?
      instructions:
      - text: List deployments on instance {instance} of non-production slot {slot} of app {app} in {rg} (subscription {sub}).
        slots:
          instance: path.instanceId
          slot: path.slot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show deployments for slot {slot} of {app} on instance {instance}.
        slots:
          slot: path.slot
          app: path.name
          instance: path.instanceId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/instances/{instanceId}/deployments/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a deployment on one app instance
      effect: read
      questions:
      - How do I look up one deployment as it ran on a particular instance?
      - What did a specific deployment record on a given app instance?
      instructions:
      - text: Get deployment {deployment} on instance {instance} of web app {app} in {rg} (subscription {sub}).
        slots:
          deployment: path.id
          instance: path.instanceId
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show deployment {deployment} for production instance {instance} of {app}.
        slots:
          deployment: path.id
          instance: path.instanceId
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/instances/{instanceId}/deployments/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Record a deployment on an app instance
      effect: write
      questions:
      - Can I create a deployment record for a single instance of my web app?
      - Is it possible to register a deployment against one scaled-out instance?
      instructions:
      - text: Create deployment {deployment} on instance {instance} of web app {app} in {rg} (subscription {sub}), location {location}.
        slots:
          deployment: path.id
          instance: path.instanceId
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
          location: requestBody.location
      - text: Add deployment record {deployment} to production instance {instance} of {app}.
        slots:
          deployment: path.id
          instance: path.instanceId
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/instances/{instanceId}/deployments/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a deployment on an app instance
      effect: destructive
      questions:
      - How do I remove a deployment record from one instance of my app?
      - Can a deployment be deleted from a single instance only?
      instructions:
      - text: Delete deployment {deployment} from instance {instance} of web app {app} in {rg} (subscription {sub}).
        slots:
          deployment: path.id
          instance: path.instanceId
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Remove deployment record {deployment} on production instance {instance} of {app}.
        slots:
          deployment: path.id
          instance: path.instanceId
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/deployments/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a web app deployment
      effect: read
      questions:
      - Which details are stored for one deployment of my production app?
      - Can I look up a single deployment by its id?
      instructions:
      - text: Get deployment {deployment} of web app {app} in {rg} (subscription {sub}).
        slots:
          deployment: path.id
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show production app {app}'s deployment {deployment}.
        slots:
          app: path.name
          deployment: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/deployments/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a deployment record for a web app
      effect: write
      questions:
      - How do I create a deployment entry for my production web app?
      - Can I register a new deployment on the main app via the API?
      instructions:
      - text: Create deployment {deployment} for web app {app} in {rg} (subscription {sub}), location {location}.
        slots:
          deployment: path.id
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
          location: requestBody.location
      - text: Add deployment record {deployment} to production app {app}.
        slots:
          deployment: path.id
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/deployments/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a web app deployment
      effect: destructive
      questions:
      - Can I delete a deployment record from my production web app?
      - What removes one entry from the main app's deployment history?
      instructions:
      - text: Delete deployment record {deployment} from the history of web app {app} in {rg} (subscription {sub}).
        slots:
          deployment: path.id
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Remove production deployment {deployment} from {app}.
        slots:
          deployment: path.id
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/deployments/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a deployment on a slot
      effect: read
      questions:
      - How do I view one deployment made to a staging slot?
      - What details does a slot keep about a specific deployment?
      instructions:
      - text: Get deployment {deployment} on non-production slot {slot} of web app {app} in {rg} (subscription {sub}).
        slots:
          deployment: path.id
          slot: path.slot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show deployment {deployment} for deployment slot {slot} of {app}.
        slots:
          deployment: path.id
          slot: path.slot
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/deployments/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a deployment record for a slot
      effect: write
      questions:
      - Can I record a new deployment against a deployment slot?
      - How is a deployment entry added to a staging slot rather than production?
      instructions:
      - text: Create deployment {deployment} on non-production slot {slot} of web app {app} in {rg} (subscription {sub}), location {location}.
        slots:
          deployment: path.id
          slot: path.slot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
          location: requestBody.location
      - text: Add deployment record {deployment} to deployment slot {slot} of {app}.
        slots:
          deployment: path.id
          slot: path.slot
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/deployments/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a deployment from a slot
      effect: destructive
      questions:
      - How do I delete a deployment record from a staging slot?
      - Can one slot's deployment history entry be removed?
      instructions:
      - text: Delete deployment history record {deployment} from non-production slot {slot} of web app {app} in {rg} (subscription {sub}).
        slots:
          deployment: path.id
          slot: path.slot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Remove deployment {deployment} from deployment slot {slot} of {app}.
        slots:
          deployment: path.id
          slot: path.slot
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/instances/{instanceId}/deployments/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a deployment on a slot instance
      effect: read
      questions:
      - Can I look up one deployment as it ran on a particular slot instance?
      - Which details exist for a deployment on one instance of a staging slot?
      instructions:
      - text: Get deployment {deployment} on instance {instance} of non-production slot {slot} of app {app} in {rg} (subscription {sub}).
        slots:
          deployment: path.id
          instance: path.instanceId
          slot: path.slot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show slot {slot} instance {instance} deployment {deployment} for {app}.
        slots:
          slot: path.slot
          instance: path.instanceId
          deployment: path.id
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/instances/{instanceId}/deployments/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Record a deployment on a slot instance
      effect: write
      questions:
      - Can I create a deployment record on a single instance of a deployment slot?
      - How would I register a deployment for one staging slot instance?
      instructions:
      - text: Create deployment {deployment} on instance {instance} of non-production slot {slot} of app {app} in {rg} (subscription {sub}), location {location}.
        slots:
          deployment: path.id
          instance: path.instanceId
          slot: path.slot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
          location: requestBody.location
      - text: Record deployment {deployment} against a single instance {instance} within slot {slot} of {app}.
        slots:
          deployment: path.id
          instance: path.instanceId
          slot: path.slot
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/instances/{instanceId}/deployments/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a deployment on a slot instance
      effect: destructive
      questions:
      - How do I remove a deployment record from one instance of a slot?
      - Can a slot instance's deployment entry be deleted on its own?
      instructions:
      - text: Delete deployment {deployment} from instance {instance} of non-production slot {slot} of app {app} in {rg} (subscription {sub}).
        slots:
          deployment: path.id
          instance: path.instanceId
          slot: path.slot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Remove slot {slot} instance {instance} deployment record {deployment} from {app}.
        slots:
          slot: path.slot
          instance: path.instanceId
          deployment: path.id
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/instances'].get
  update:
    x-apievangelist-phrasing:
      intent: List a web app's instances
      effect: read
      questions:
      - How many instances is my production web app running on?
      - Where do I get the instance ids for a scaled-out app?
      instructions:
      - text: List the instances of web app {app} in {rg} (subscription {sub}).
        slots:
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show instance identifiers for production app {app}.
        slots:
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/instances'].get
  update:
    x-apievangelist-phrasing:
      intent: List a deployment slot's instances
      effect: read
      questions:
      - Which instances is my staging slot running on?
      - Can I get instance ids for a deployment slot?
      instructions:
      - text: List the instances of non-production slot {slot} of web app {app} in {rg} (subscription {sub}).
        slots:
          slot: path.slot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show instance identifiers for deployment slot {slot} of {app}.
        slots:
          slot: path.slot
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/hostNameBindings'].get
  update:
    x-apievangelist-phrasing:
      intent: List a web app's hostname bindings
      effect: read
      questions:
      - Which custom domains are bound to my production web app?
      - Can I list every hostname binding on the main app?
      instructions:
      - text: List hostname bindings of web app {app} in {rg} (subscription {sub}).
        slots:
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show all custom domains bound to production app {app}.
        slots:
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/hostNameBindings'].get
  update:
    x-apievangelist-phrasing:
      intent: List a slot's hostname bindings
      effect: read
      questions:
      - What hostnames are bound to my staging slot?
      - Does a deployment slot have its own custom domain bindings I can list?
      instructions:
      - text: List hostname bindings of non-production slot {slot} of web app {app} in {rg} (subscription {sub}).
        slots:
          slot: path.slot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show custom domains bound to deployment slot {slot} of {app}.
        slots:
          slot: path.slot
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/hostNameBindings/{hostName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a web app's binding for a hostname
      effect: read
      questions:
      - How do I check the binding for one custom domain on my web app?
      - What SSL and verification details does a single hostname binding have?
      instructions:
      - text: Get the binding for hostname {hostname} on web app {app} in {rg} (subscription {sub}).
        slots:
          hostname: path.hostName
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show production app {app}'s binding for domain {hostname}.
        slots:
          app: path.name
          hostname: path.hostName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/hostNameBindings/{hostName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Bind a custom hostname to a web app
      effect: write
      questions:
      - How do I add a custom domain to my production web app?
      - Can I update an existing hostname binding on the main app?
      instructions:
      - text: Bind hostname {hostname} to web app {app} in {rg} (subscription {sub}), location {location}.
        slots:
          hostname: path.hostName
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
          location: requestBody.location
      - text: Create or update production app {app}'s binding for domain {hostname}.
        slots:
          app: path.name
          hostname: path.hostName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/hostNameBindings/{hostName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a hostname binding from a web app
      effect: destructive
      questions:
      - How do I remove a custom domain from my production web app?
      - Will deleting a hostname binding stop the main app answering on that domain?
      instructions:
      - text: Delete the binding for hostname {hostname} on web app {app} in {rg} (subscription {sub}).
        slots:
          hostname: path.hostName
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Unbind domain {hostname} from production app {app}.
        slots:
          hostname: path.hostName
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/hostNameBindings/{hostName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a slot's binding for a hostname
      effect: read
      questions:
      - Can I check one custom domain binding on a deployment slot?
      - What does the hostname binding on my staging slot contain?
      instructions:
      - text: Get the binding for hostname {hostname} on non-production slot {slot} of app {app} in {rg} (subscription {sub}).
        slots:
          hostname: path.hostName
          slot: path.slot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show deployment slot {slot} of {app}'s binding for domain {hostname}.
        slots:
          slot: path.slot
          app: path.name
          hostname: path.hostName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/hostNameBindings/{hostName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Bind a custom hostname to a slot
      effect: write
      questions:
      - How do I give a staging slot its own custom domain?
      - Can a hostname binding be created on a deployment slot rather than production?
      instructions:
      - text: Bind hostname {hostname} to non-production slot {slot} of web app {app} in {rg} (subscription {sub}), location {location}.
        slots:
          hostname: path.hostName
          slot: path.slot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
          location: requestBody.location
      - text: Create or update deployment slot {slot} of {app}'s binding for {hostname}.
        slots:
          slot: path.slot
          app: path.name
          hostname: path.hostName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/hostNameBindings/{hostName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a hostname binding from a slot
      effect: destructive
      questions:
      - How do I unbind a custom domain from a deployment slot?
      - Can I drop a staging slot's hostname without touching production?
      instructions:
      - text: Remove the custom domain binding for hostname {hostname} from non-production slot {slot} of app {app} in {rg} (subscription {sub}).
        slots:
          hostname: path.hostName
          slot: path.slot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Unbind domain {hostname} from deployment slot {slot} of {app}.
        slots:
          hostname: path.hostName
          slot: path.slot
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/config/web'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a web app's site configuration
      effect: read
      questions:
      - What runtime, TLS and always-on settings does my production web app use?
      - Where do I read the main app's web configuration?
      instructions:
      - text: Get the site configuration of web app {app} in {rg} (subscription {sub}).
        slots:
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show production app {app}'s web config.
        slots:
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/config/web'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace a web app's site configuration
      effect: write
      questions:
      - How do I overwrite the whole web configuration of my production app?
      - Can I set the main app's site config in one full PUT?
      instructions:
      - text: Replace the site configuration of web app {app} in {rg} (subscription {sub}), location {location}.
        slots:
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
          location: requestBody.location
      - text: Overwrite production app {app}'s full web config.
        slots:
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/config/web'].patch
  update:
    x-apievangelist-phrasing:
      intent: Patch a web app's site configuration
      effect: write
      questions:
      - Can I change a single web config setting on my production app without resending everything?
      - Is there a PATCH for the main app's site configuration?
      instructions:
      - text: Patch the site configuration of web app {app} in {rg} (subscription {sub}), location {location}.
        slots:
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
          location: requestBody.location
      - text: Partially update production app {app}'s web config.
        slots:
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/config/web'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a slot's site configuration
      effect: read
      questions:
      - What web configuration is my staging slot running with?
      - Can I read a deployment slot's runtime and TLS settings?
      instructions:
      - text: Get the site configuration of non-production slot {slot} of web app {app} in {rg} (subscription {sub}).
        slots:
          slot: path.slot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show deployment slot {slot} of {app}'s web config.
        slots:
          slot: path.slot
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/config/web'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace a slot's site configuration
      effect: write
      questions:
      - How do I overwrite a deployment slot's entire web configuration?
      - Can a staging slot's site config be replaced in one call?
      instructions:
      - text: Replace the site configuration of non-production slot {slot} of app {app} in {rg} (subscription {sub}), location {location}.
        slots:
          slot: path.slot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
          location: requestBody.location
      - text: Overwrite deployment slot {slot} of {app}'s full web config.
        slots:
          slot: path.slot
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/config/web'].patch
  update:
    x-apievangelist-phrasing:
      intent: Patch a slot's site configuration
      effect: write
      questions:
      - Can I patch just one web config value on a staging slot?
      - How is a deployment slot's site configuration partially updated?
      instructions:
      - text: Patch the site configuration of non-production slot {slot} of app {app} in {rg} (subscription {sub}), location {location}.
        slots:
          slot: path.slot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
          location: requestBody.location
      - text: Partially update deployment slot {slot} of {app}'s web config.
        slots:
          slot: path.slot
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/sourcecontrols/web'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a web app's source control setup
      effect: read
      questions:
      - Which repository and branch is my production web app deploying from?
      - How can I check the main app's source control configuration?
      instructions:
      - text: Get the source control configuration of web app {app} in {rg} (subscription {sub}).
        slots:
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show which repo and branch production app {app} deploys from.
        slots:
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/sourcecontrols/web'].put
  update:
    x-apievangelist-phrasing:
      intent: Set a web app's source control
      effect: write
      questions:
      - How do I connect my production web app to a Git repository for deployment?
      - Can I replace the main app's source control settings entirely?
      instructions:
      - text: Configure source control for web app {app} in {rg} (subscription {sub}), location {location}.
        slots:
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
          location: requestBody.location
      - text: Create or replace production app {app}'s repository deployment settings.
        slots:
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/sourcecontrols/web'].delete
  update:
    x-apievangelist-phrasing:
      intent: Disconnect source control from an app
      effect: destructive
      questions:
      - How do I stop my production app from deploying from its repository?
      - Can I unlink the main web app from its Git repo without touching its slots?
      instructions:
      - text: Delete the source control configuration of {app}.
        slots:
          app: path.name
      - text: Disconnect the repo from production {app}, group {group}, subscription {subscription}.
        slots:
          app: path.name
          group: path.resourceGroupName
          subscription: path.subscriptionId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/sourcecontrols/web'].patch
  update:
    x-apievangelist-phrasing:
      intent: Patch a web app's source control
      effect: write
      questions:
      - Can I change only the branch in my production app's source control settings?
      - Is there a partial update for the main app's repository configuration?
      instructions:
      - text: Patch the source control configuration of web app {app} in {rg} (subscription {sub}), location {location}.
        slots:
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
          location: requestBody.location
      - text: Partially update production app {app}'s repository deployment settings.
        slots:
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/sourcecontrols/web'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a slot's source control setup
      effect: read
      questions:
      - Which repository and branch feeds my staging slot?
      - Can I read a deployment slot's source control configuration?
      instructions:
      - text: Get the source control configuration of non-production slot {slot} of app {app} in {rg} (subscription {sub}).
        slots:
          slot: path.slot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show which repo and branch deployment slot {slot} of {app} deploys from.
        slots:
          slot: path.slot
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/sourcecontrols/web'].put
  update:
    x-apievangelist-phrasing:
      intent: Set a slot's source control
      effect: write
      questions:
      - How do I hook a deployment slot up to a Git branch?
      - Can a staging slot deploy from its own repository settings?
      instructions:
      - text: Configure source control for non-production slot {slot} of web app {app} in {rg} (subscription {sub}), location {location}.
        slots:
          slot: path.slot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
          location: requestBody.location
      - text: Create or replace deployment slot {slot} of {app}'s repository settings.
        slots:
          slot: path.slot
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/sourcecontrols/web'].delete
  update:
    x-apievangelist-phrasing:
      intent: Disconnect source control from a slot
      effect: destructive
      questions:
      - How do I stop a deployment slot from deploying from its repository?
      - Can I unlink only a staging slot from its Git repo and leave production connected?
      instructions:
      - text: Delete the source control configuration of slot {slot} on {app}.
        slots:
          slot: path.slot
          app: path.name
      - text: Disconnect the repo from {app} slot {slot}, group {group}, subscription {subscription}.
        slots:
          app: path.name
          slot: path.slot
          group: path.resourceGroupName
          subscription: path.subscriptionId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/sourcecontrols/web'].patch
  update:
    x-apievangelist-phrasing:
      intent: Patch a slot's source control
      effect: write
      questions:
      - Can I partially change a deployment slot's repository settings?
      - Is there a PATCH for a staging slot's source control config?
      instructions:
      - text: Patch the source control configuration of non-production slot {slot} of app {app} in {rg} (subscription {sub}), location {location}.
        slots:
          slot: path.slot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
          location: requestBody.location
      - text: Partially update deployment slot {slot} of {app}'s repository settings.
        slots:
          slot: path.slot
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/config/appsettings/list'].post
  update:
    x-apievangelist-phrasing:
      intent: List a slot's application settings
      effect: read
      questions:
      - What application settings are configured on my staging slot?
      - Can I read environment variables for one deployment slot?
      instructions:
      - text: List app settings of non-production slot {slot} of web app {app} in {rg} (subscription {sub}).
        slots:
          slot: path.slot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show application settings for deployment slot {slot} of {app}.
        slots:
          slot: path.slot
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/config/appsettings/list'].post
  update:
    x-apievangelist-phrasing:
      intent: List a web app's application settings
      effect: read
      questions:
      - What application settings does my production web app have?
      - How do I read the main app's environment variables?
      instructions:
      - text: List app settings of web app {app} in {rg} (subscription {sub}).
        slots:
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show application settings for production app {app}.
        slots:
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/config/appsettings'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace a web app's application settings
      effect: write
      questions:
      - How do I update the application settings on my production web app?
      - Does writing app settings replace the whole set on the main app?
      instructions:
      - text: Replace the app settings of web app {app} in {rg} (subscription {sub}), location {location}.
        slots:
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
          location: requestBody.location
      - text: Update production app {app}'s application settings.
        slots:
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/config/appsettings'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace a slot's application settings
      effect: write
      questions:
      - Can I set different application settings on a staging slot?
      - How are a deployment slot's environment variables updated?
      instructions:
      - text: Replace the app settings of non-production slot {slot} of web app {app} in {rg} (subscription {sub}), location {location}.
        slots:
          slot: path.slot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
          location: requestBody.location
      - text: Update application settings for deployment slot {slot} of {app}.
        slots:
          slot: path.slot
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/config/connectionstrings/list'].post
  update:
    x-apievangelist-phrasing:
      intent: List a web app's connection strings
      effect: read
      questions:
      - Which database connection strings are set on my production web app?
      - Can I read the main app's connection strings through the API?
      instructions:
      - text: List connection strings of web app {app} in {rg} (subscription {sub}).
        slots:
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show production app {app}'s connection strings.
        slots:
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/config/connectionstrings/list'].post
  update:
    x-apievangelist-phrasing:
      intent: List a slot's connection strings
      effect: read
      questions:
      - What connection strings is my staging slot using?
      - Can a deployment slot's database connection strings be listed?
      instructions:
      - text: List connection strings of non-production slot {slot} of web app {app} in {rg} (subscription {sub}).
        slots:
          slot: path.slot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show deployment slot {slot} of {app}'s connection strings.
        slots:
          slot: path.slot
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/config/connectionstrings'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace a web app's connection strings
      effect: write
      questions:
      - How do I change the connection strings on my production web app?
      - Can I point the main app at a new database by updating its connection strings?
      instructions:
      - text: Replace the connection strings of web app {app} in {rg} (subscription {sub}), location {location}.
        slots:
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
          location: requestBody.location
      - text: Update production app {app}'s database connection strings.
        slots:
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/config/connectionstrings'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace a slot's connection strings
      effect: write
      questions:
      - Can a staging slot use its own connection strings?
      - How do I update database connection strings on a deployment slot?
      instructions:
      - text: Replace the connection strings of non-production slot {slot} of web app {app} in {rg} (subscription {sub}), location {location}.
        slots:
          slot: path.slot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
          location: requestBody.location
      - text: Update deployment slot {slot} of {app}'s connection strings.
        slots:
          slot: path.slot
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/config/authsettings/list'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a web app's authentication settings
      effect: read
      questions:
      - Is App Service authentication turned on for my production web app?
      - Which identity provider and allowed audiences does the main app's auth use?
      instructions:
      - text: Get the authentication settings of web app {app} in {rg} (subscription {sub}).
        slots:
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show production app {app}'s auth and authorization config.
        slots:
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/config/authsettings/list'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a slot's authentication settings
      effect: read
      questions:
      - What authentication settings apply to my staging slot?
      - Does a deployment slot have sign-in enabled, and with which provider?
      instructions:
      - text: Get the authentication settings of non-production slot {slot} of web app {app} in {rg} (subscription {sub}).
        slots:
          slot: path.slot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show deployment slot {slot} of {app}'s auth configuration.
        slots:
          slot: path.slot
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/config/authsettings'].put
  update:
    x-apievangelist-phrasing:
      intent: Update classic auth settings
      effect: write
      questions:
      - How do I change the classic authentication/authorization settings of my production app?
      - Can I turn on App Service Authentication using the older auth settings format?
      instructions:
      - text: Update classic auth settings for app {name} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          name: path.name
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Turn classic authentication {enabled} on production app {name} with default provider {defaultProvider}.
        slots:
          enabled: requestBody.enabled
          name: path.name
          defaultProvider: requestBody.defaultProvider
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/config/authsettings'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a slot's classic auth settings
      effect: write
      questions:
      - How do I change classic authentication settings on a deployment slot?
      - Can I turn on App Service Authentication for a staging slot with the older format?
      instructions:
      - text: Update classic auth settings of slot {slot} of app {name} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          slot: path.slot
          name: path.name
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Set unauthenticated requests on deployment slot {slot} of {name} to {unauthenticatedClientAction} under classic auth.
        slots:
          slot: path.slot
          name: path.name
          unauthenticatedClientAction: requestBody.unauthenticatedClientAction
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/config/publishingcredentials/list'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a web app's publishing credentials
      effect: read
      questions:
      - Where do I get the deployment username and password for my production web app?
      - Can I fetch the main app's FTP and Web Deploy credentials?
      instructions:
      - text: Get the publishing credentials of web app {app} in {rg} (subscription {sub}).
        slots:
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show production app {app}'s deployment credentials.
        slots:
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/config/publishingcredentials/list'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a slot's publishing credentials
      effect: read
      questions:
      - What credentials do I use to deploy to a staging slot?
      - Can a deployment slot's publishing username and password be retrieved?
      instructions:
      - text: Get the publishing credentials of non-production slot {slot} of web app {app} in {rg} (subscription {sub}).
        slots:
          slot: path.slot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show deployment slot {slot} of {app}'s deployment credentials.
        slots:
          slot: path.slot
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/config/metadata/list'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a web app's metadata
      effect: read
      questions:
      - What metadata key-value pairs are stored on my production web app?
      - Can I read the main app's site metadata?
      instructions:
      - text: Get the metadata of web app {app} in {rg} (subscription {sub}).
        slots:
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show production app {app}'s metadata entries.
        slots:
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/config/metadata/list'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a slot's metadata
      effect: read
      questions:
      - Which metadata is attached to my staging slot?
      - Can a deployment slot's metadata be read separately?
      instructions:
      - text: Get the metadata of non-production slot {slot} of web app {app} in {rg} (subscription {sub}).
        slots:
          slot: path.slot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show deployment slot {slot} of {app}'s metadata entries.
        slots:
          slot: path.slot
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/config/metadata'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace a web app's metadata
      effect: write
      questions:
      - How do I update the metadata stored on my production web app?
      - Can I overwrite the main app's metadata key-value pairs?
      instructions:
      - text: Replace the metadata of web app {app} in {rg} (subscription {sub}), location {location}.
        slots:
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
          location: requestBody.location
      - text: Update production app {app}'s metadata entries.
        slots:
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/config/metadata'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace a slot's metadata
      effect: write
      questions:
      - Can I set metadata on a deployment slot?
      - How is a staging slot's metadata overwritten?
      instructions:
      - text: Replace the metadata of non-production slot {slot} of web app {app} in {rg} (subscription {sub}), location {location}.
        slots:
          slot: path.slot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
          location: requestBody.location
      - text: Update deployment slot {slot} of {app}'s metadata entries.
        slots:
          slot: path.slot
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/config/logs'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a web app's logging configuration
      effect: read
      questions:
      - Is application or web server logging enabled on my production web app?
      - Where are the main app's logs being written?
      instructions:
      - text: Get the logs configuration of web app {app} in {rg} (subscription {sub}).
        slots:
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show production app {app}'s diagnostic logging settings.
        slots:
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/config/logs'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a web app's logging configuration
      effect: write
      questions:
      - How do I turn on diagnostic logging for my production web app?
      - Can I change where the main app stores its logs?
      instructions:
      - text: Update the logs configuration of web app {app} in {rg} (subscription {sub}), location {location}.
        slots:
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
          location: requestBody.location
      - text: Change production app {app}'s diagnostic logging settings.
        slots:
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/config/logs'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a slot's logging configuration
      effect: read
      questions:
      - What logging is configured on my staging slot?
      - Can I read a deployment slot's diagnostic log settings?
      instructions:
      - text: Get the logs configuration of non-production slot {slot} of web app {app} in {rg} (subscription {sub}).
        slots:
          slot: path.slot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show deployment slot {slot} of {app}'s diagnostic logging settings.
        slots:
          slot: path.slot
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/config/logs'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a slot's logging configuration
      effect: write
      questions:
      - Can I enable diagnostic logging only on a staging slot?
      - How do I change log storage for a deployment slot?
      instructions:
      - text: Update the logs configuration of non-production slot {slot} of web app {app} in {rg} (subscription {sub}), location {location}.
        slots:
          slot: path.slot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
          location: requestBody.location
      - text: Change deployment slot {slot} of {app}'s diagnostic logging settings.
        slots:
          slot: path.slot
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/premieraddons'].get
  update:
    x-apievangelist-phrasing:
      intent: List a web app's premier add-ons
      effect: read
      questions:
      - Which premier add-ons are installed on my production web app?
      - Can I see all add-ons attached to the main app?
      instructions:
      - text: List premier add-ons of web app {app} in {rg} (subscription {sub}).
        slots:
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show all add-ons installed on production app {app}.
        slots:
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/premieraddons'].get
  update:
    x-apievangelist-phrasing:
      intent: List a slot's premier add-ons
      effect: read
      questions:
      - What premier add-ons are on my staging slot?
      - Can I list add-ons for one deployment slot?
      instructions:
      - text: List premier add-ons of non-production slot {slot} of web app {app} in {rg} (subscription {sub}).
        slots:
          slot: path.slot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show all add-ons installed on deployment slot {slot} of {app}.
        slots:
          slot: path.slot
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/premieraddons/{premierAddOnName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a premier add-on on a web app
      effect: read
      questions:
      - How do I look up one premier add-on on my production web app?
      - What plan and SKU does a specific add-on on the main app use?
      instructions:
      - text: Get premier add-on {addon} on web app {app} in {rg} (subscription {sub}).
        slots:
          addon: path.premierAddOnName
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show production app {app}'s add-on {addon}.
        slots:
          app: path.name
          addon: path.premierAddOnName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/premieraddons/{premierAddOnName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Add a premier add-on to a web app
      effect: write
      questions:
      - How do I install a premier add-on on my production web app?
      - Can I pick the SKU and plan when adding an add-on to the main app?
      instructions:
      - text: Add premier add-on {addon} to web app {app} in {rg} (subscription {sub}).
        slots:
          addon: path.premierAddOnName
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Install add-on {addon} on production app {app} with SKU {sku}.
        slots:
          addon: path.premierAddOnName
          app: path.name
          sku: requestBody.sku
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/premieraddons/{premierAddOnName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a premier add-on from a web app
      effect: destructive
      questions:
      - How do I uninstall a premier add-on from my production web app?
      - Can an add-on be removed from the main app through the API?
      instructions:
      - text: Delete premier add-on {addon} from web app {app} in {rg} (subscription {sub}).
        slots:
          addon: path.premierAddOnName
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Uninstall add-on {addon} from production app {app}.
        slots:
          addon: path.premierAddOnName
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/premieraddons/{premierAddOnName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a premier add-on on a slot
      effect: read
      questions:
      - Can I look up one premier add-on on a deployment slot?
      - Which plan does a specific add-on on my staging slot have?
      instructions:
      - text: Get premier add-on {addon} on non-production slot {slot} of web app {app} in {rg} (subscription {sub}).
        slots:
          addon: path.premierAddOnName
          slot: path.slot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show deployment slot {slot} of {app}'s add-on {addon}.
        slots:
          slot: path.slot
          app: path.name
          addon: path.premierAddOnName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/premieraddons/{premierAddOnName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Add a premier add-on to a slot
      effect: write
      questions:
      - Can I install a premier add-on on a staging slot only?
      - How do I add an add-on with a chosen SKU to a deployment slot?
      instructions:
      - text: Add premier add-on {addon} to non-production slot {slot} of web app {app} in {rg} (subscription {sub}).
        slots:
          addon: path.premierAddOnName
          slot: path.slot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Install add-on {addon} on deployment slot {slot} of {app} with SKU {sku}.
        slots:
          addon: path.premierAddOnName
          slot: path.slot
          app: path.name
          sku: requestBody.sku
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/premieraddons/{premierAddOnName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a premier add-on from a slot
      effect: destructive
      questions:
      - How do I uninstall an add-on from a deployment slot?
      - Can a staging slot's premier add-on be removed without touching production?
      instructions:
      - text: Delete premier add-on {addon} from non-production slot {slot} of web app {app} in {rg} (subscription {sub}).
        slots:
          addon: path.premierAddOnName
          slot: path.slot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Uninstall add-on {addon} from deployment slot {slot} of {app}.
        slots:
          addon: path.premierAddOnName
          slot: path.slot
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/config/backup/list'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a web app's backup schedule
      effect: read
      questions:
      - Is a scheduled backup configured for my production web app?
      - What storage and retention does the main app's backup configuration use?
      instructions:
      - text: Get the backup configuration of web app {app} in {rg} (subscription {sub}).
        slots:
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show production app {app}'s scheduled backup settings.
        slots:
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/config/backup/list'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a slot's backup schedule
      effect: read
      questions:
      - Does my staging slot have scheduled backups set up?
      - Can I read a deployment slot's backup configuration?
      instructions:
      - text: Get the backup configuration of non-production slot {slot} of web app {app} in {rg} (subscription {sub}).
        slots:
          slot: path.slot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show deployment slot {slot} of {app}'s scheduled backup settings.
        slots:
          slot: path.slot
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/config/backup'].put
  update:
    x-apievangelist-phrasing:
      intent: Set a web app's backup schedule
      effect: write
      questions:
      - How do I schedule automatic backups for my production web app?
      - Can I change the retention of the main app's scheduled backups?
      instructions:
      - text: Update the backup configuration of web app {app} in {rg} (subscription {sub}), location {location}.
        slots:
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
          location: requestBody.location
      - text: Set up scheduled backups for production app {app}.
        slots:
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/config/backup'].put
  update:
    x-apievangelist-phrasing:
      intent: Set a slot's backup schedule
      effect: write
      questions:
      - Can a deployment slot get its own backup schedule?
      - How do I configure automatic backups on a staging slot?
      instructions:
      - text: Change the scheduled backup policy of non-production slot {slot} of web app {app} in {rg} (subscription {sub}), location {location}.
        slots:
          slot: path.slot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
          location: requestBody.location
      - text: Set up scheduled backups for deployment slot {slot} of {app}.
        slots:
          slot: path.slot
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/backup'].post
  update:
    x-apievangelist-phrasing:
      intent: Back up a web app now
      effect: write
      questions:
      - How do I take an on-demand backup of my production web app?
      - Can I trigger a one-off backup of the main app right away?
      instructions:
      - text: Back up web app {app} in {rg} (subscription {sub}) now, location {location}.
        slots:
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
          location: requestBody.location
      - text: Create an on-demand backup of production app {app}.
        slots:
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/backup'].post
  update:
    x-apievangelist-phrasing:
      intent: Back up a deployment slot now
      effect: write
      questions:
      - Can I take a manual backup of just a staging slot?
      - How is an immediate backup of a deployment slot created?
      instructions:
      - text: Back up non-production slot {slot} of web app {app} in {rg} (subscription {sub}) now, location {location}.
        slots:
          slot: path.slot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
          location: requestBody.location
      - text: Create an on-demand backup of deployment slot {slot} of {app}.
        slots:
          slot: path.slot
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/backups/discover'].put
  update:
    x-apievangelist-phrasing:
      intent: Discover restorable backups for a web app
      effect: read
      questions:
      - Which existing backups in storage could I restore into my production web app?
      - Can I find backups that are restorable to the main app before restoring?
      instructions:
      - text: Discover backups that can be restored to web app {app} in {rg} (subscription {sub}), location {location}.
        slots:
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
          location: requestBody.location
      - text: Find restorable backups in storage for production app {app}.
        slots:
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/backups/discover'].put
  update:
    x-apievangelist-phrasing:
      intent: Discover restorable backups for a slot
      effect: read
      questions:
      - What backups in storage can be restored to a deployment slot?
      - Can I discover restorable backups for my staging slot?
      instructions:
      - text: Discover backups that can be restored to non-production slot {slot} of app {app} in {rg} (subscription {sub}), location {location}.
        slots:
          slot: path.slot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
          location: requestBody.location
      - text: Find restorable backups in storage for deployment slot {slot} of {app}.
        slots:
          slot: path.slot
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/backups'].get
  update:
    x-apievangelist-phrasing:
      intent: List a web app's backups
      effect: read
      questions:
      - What backups exist for my production web app?
      - Can I list every available backup of the main app?
      instructions:
      - text: List backups of web app {app} in {rg} (subscription {sub}).
        slots:
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show all available backups for production app {app}.
        slots:
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/backups'].get
  update:
    x-apievangelist-phrasing:
      intent: List a slot's backups
      effect: read
      questions:
      - Which backups have been taken of my staging slot?
      - Can a deployment slot's backups be listed?
      instructions:
      - text: List backups of non-production slot {slot} of web app {app} in {rg} (subscription {sub}).
        slots:
          slot: path.slot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show all available backups for deployment slot {slot} of {app}.
        slots:
          slot: path.slot
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/backups/{backupId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check a web app backup's status
      effect: read
      questions:
      - Is the backup I started on my production web app still running?
      - How do I check whether a specific backup of the main app succeeded?
      instructions:
      - text: Get the status of backup {backup} of web app {app} in {rg} (subscription {sub}).
        slots:
          backup: path.backupId
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Check progress of production app {app}'s backup {backup}.
        slots:
          app: path.name
          backup: path.backupId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/backups/{backupId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a web app backup
      effect: destructive
      questions:
      - How do I delete an old backup of my production web app from storage?
      - Can a single backup of the main app be removed from Azure Storage?
      instructions:
      - text: Delete backup {backup} of web app {app} in {rg} (subscription {sub}).
        slots:
          backup: path.backupId
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Remove production app {app}'s backup {backup} from storage.
        slots:
          app: path.name
          backup: path.backupId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/backups/{backupId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check a slot backup's status
      effect: read
      questions:
      - Has the backup of my staging slot finished?
      - Can I check one deployment slot backup's progress?
      instructions:
      - text: Get the status of backup {backup} of non-production slot {slot} of app {app} in {rg} (subscription {sub}).
        slots:
          backup: path.backupId
          slot: path.slot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Check progress of deployment slot {slot} of {app}'s backup {backup}.
        slots:
          slot: path.slot
          app: path.name
          backup: path.backupId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/backups/{backupId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a slot backup
      effect: destructive
      questions:
      - How do I delete a backup that was taken of a deployment slot?
      - Can one staging slot backup be removed from storage?
      instructions:
      - text: Delete backup {backup} of non-production slot {slot} of web app {app} in {rg} (subscription {sub}).
        slots:
          backup: path.backupId
          slot: path.slot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Remove deployment slot {slot} of {app}'s backup {backup} from storage.
        slots:
          slot: path.slot
          app: path.name
          backup: path.backupId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/backups/{backupId}/list'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a slot backup's status with secrets
      effect: read
      questions:
      - Can I see a slot backup's status including its storage secrets?
      - Where do I get the SAS URL and secrets of a staging slot backup?
      instructions:
      - text: Get backup {backup} status with secrets for non-production slot {slot} of app {app} in {rg} (subscription {sub}), location {location}.
        slots:
          backup: path.backupId
          slot: path.slot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
          location: requestBody.location
      - text: Show deployment slot {slot} of {app}'s backup {backup} including secrets.
        slots:
          slot: path.slot
          app: path.name
          backup: path.backupId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/backups/{backupId}/list'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a web app backup's status with secrets
      effect: read
      questions:
      - How do I get a production backup's status along with its secrets?
      - Can the main app's backup details include the storage SAS URL?
      instructions:
      - text: Get backup {backup} status with secrets for web app {app} in {rg} (subscription {sub}), location {location}.
        slots:
          backup: path.backupId
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
          location: requestBody.location
      - text: Show production app {app}'s backup {backup} including secrets.
        slots:
          app: path.name
          backup: path.backupId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/backups/{backupId}/restore'].post
  update:
    x-apievangelist-phrasing:
      intent: Restore a web app from a backup
      effect: destructive
      questions:
      - How do I restore my production web app from a backup?
      - Will restoring a backup overwrite the main app's current content?
      instructions:
      - text: Restore web app {app} in {rg} (subscription {sub}) from backup {backup}, location {location}.
        slots:
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
          backup: path.backupId
          location: requestBody.location
      - text: Roll production app {app} back to backup {backup}.
        slots:
          app: path.name
          backup: path.backupId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/backups/{backupId}/restore'].post
  update:
    x-apievangelist-phrasing:
      intent: Restore a slot from a backup
      effect: destructive
      questions:
      - Can I restore just a staging slot from one of its backups?
      - How is a deployment slot rolled back to an earlier backup?
      instructions:
      - text: Restore non-production slot {slot} of web app {app} in {rg} (subscription {sub}) from backup {backup}, location {location}.
        slots:
          slot: path.slot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
          backup: path.backupId
          location: requestBody.location
      - text: Roll deployment slot {slot} of {app} back to backup {backup}.
        slots:
          slot: path.slot
          app: path.name
          backup: path.backupId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/usages'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a web app's quota usage
      effect: read
      questions:
      - How much of its quotas, such as CPU time or file system, is my production app using?
      - Can I filter quota usage to specific metrics with an OData filter?
      instructions:
      - text: Get quota usage for web app {app} in {rg} (subscription {sub}).
        slots:
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show production app {app}'s usage filtered by {filter}.
        slots:
          app: path.name
          filter: query.$filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/usages'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a slot's quota usage
      effect: read
      questions:
      - What quota usage is my staging slot reporting?
      - Can a deployment slot's usages be filtered by name?
      instructions:
      - text: Get quota usage for non-production slot {slot} of web app {app} in {rg} (subscription {sub}).
        slots:
          slot: path.slot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show deployment slot {slot} of {app}'s usage filtered by {filter}.
        slots:
          slot: path.slot
          app: path.name
          filter: query.$filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/metrics'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a web app's metrics
      effect: read
      questions:
      - How do I pull metrics like requests or response time for my production web app?
      - Can I include metric details or filter by time range for the main app?
      instructions:
      - text: Get metrics for web app {app} in {rg} (subscription {sub}).
        slots:
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: 'Show production app {app}''s metrics matching {filter}, with details: {details}.'
        slots:
          app: path.name
          filter: query.$filter
          details: query.details
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/metrics'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a slot's metrics
      effect: read
      questions:
      - What performance metrics is my staging slot producing?
      - Can I filter a deployment slot's metrics to specific names?
      instructions:
      - text: Get metrics for non-production slot {slot} of web app {app} in {rg} (subscription {sub}).
        slots:
          slot: path.slot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show deployment slot {slot} of {app}'s metrics matching {filter}.
        slots:
          slot: path.slot
          app: path.name
          filter: query.$filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/metricdefinitions'].get
  update:
    x-apievangelist-phrasing:
      intent: List metric definitions for a slot
      effect: read
      questions:
      - Which metrics are available to query on a deployment slot?
      - What units and aggregations do my staging slot's metrics support?
      instructions:
      - text: List metric definitions for non-production slot {slot} of web app {app} in {rg} (subscription {sub}).
        slots:
          slot: path.slot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show what metrics deployment slot {slot} of {app} can report.
        slots:
          slot: path.slot
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/metricdefinitions'].get
  update:
    x-apievangelist-phrasing:
      intent: List metric definitions for a web app
      effect: read
      questions:
      - What metric names can I request for my production web app?
      - Which aggregations are defined for the main app's metrics?
      instructions:
      - text: List metric definitions for web app {app} in {rg} (subscription {sub}).
        slots:
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show what metrics production app {app} can report.
        slots:
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/publishxml'].post
  update:
    x-apievangelist-phrasing:
      intent: Download a publishing profile
      effect: read
      questions:
      - How do I download my production app's publishing profile for Visual Studio or FTP?
      - Can I get the publish profile in FileZilla3, WebDeploy or FTP format?
      instructions:
      - text: Get the publishing profile of app {name} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          name: path.name
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Download the production publish profile of {name} in format {format}.
        slots:
          name: path.name
          format: requestBody.format
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/publishxml'].post
  update:
    x-apievangelist-phrasing:
      intent: Download a slot's publishing profile
      effect: read
      questions:
      - Where do I get a staging slot's publish profile?
      - Can a deployment slot's publishing profile be exported as WebDeploy XML?
      instructions:
      - text: Get the publishing profile of non-production slot {slot} of web app {app} in {rg} (subscription {sub}).
        slots:
          slot: path.slot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Download deployment slot {slot} of {app}'s publish profile in {format} format.
        slots:
          slot: path.slot
          app: path.name
          format: requestBody.format
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/restart'].post
  update:
    x-apievangelist-phrasing:
      intent: Restart a deployment slot
      effect: write
      questions:
      - How do I restart just my staging slot?
      - Can I soft-restart a deployment slot and wait for it to finish?
      instructions:
      - text: Restart non-production slot {slot} of web app {app} in {rg} (subscription {sub}).
        slots:
          slot: path.slot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: 'Soft-restart deployment slot {slot} of {app}: {soft_restart}, synchronously: {synchronous}.'
        slots:
          slot: path.slot
          app: path.name
          soft_restart: query.softRestart
          synchronous: query.synchronous
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/restart'].post
  update:
    x-apievangelist-phrasing:
      intent: Restart a web app
      effect: write
      questions:
      - How do I restart my production web app?
      - What's the difference between a soft and hard restart of the main app?
      instructions:
      - text: Restart web app {app} in {rg} (subscription {sub}).
        slots:
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Restart production app {app} with soft restart {soft_restart}.
        slots:
          app: path.name
          soft_restart: query.softRestart
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/start'].post
  update:
    x-apievangelist-phrasing:
      intent: Start a web app
      effect: write
      questions:
      - How do I start a stopped production web app?
      - Can I bring the main app back online via the API?
      instructions:
      - text: Start web app {app} in {rg} (subscription {sub}).
        slots:
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Turn production app {app} back on.
        slots:
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/start'].post
  update:
    x-apievangelist-phrasing:
      intent: Start a deployment slot
      effect: write
      questions:
      - Can I start a stopped staging slot?
      - How is one deployment slot brought back up?
      instructions:
      - text: Start non-production slot {slot} of web app {app} in {rg} (subscription {sub}).
        slots:
          slot: path.slot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Turn deployment slot {slot} of {app} back on.
        slots:
          slot: path.slot
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/stop'].post
  update:
    x-apievangelist-phrasing:
      intent: Stop a web app
      effect: write
      questions:
      - How do I stop my production web app from serving traffic?
      - Can I take the main app offline temporarily?
      instructions:
      - text: Stop web app {app} in {rg} (subscription {sub}).
        slots:
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Take production app {app} offline.
        slots:
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/stop'].post
  update:
    x-apievangelist-phrasing:
      intent: Stop a deployment slot
      effect: write
      questions:
      - Can I stop a staging slot while leaving production running?
      - How do I shut down one deployment slot?
      instructions:
      - text: Stop non-production slot {slot} of web app {app} in {rg} (subscription {sub}).
        slots:
          slot: path.slot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Take deployment slot {slot} of {app} offline.
        slots:
          slot: path.slot
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/sync'].post
  update:
    x-apievangelist-phrasing:
      intent: Sync a web app with its repository
      effect: write
      questions:
      - How do I pull the latest code from source control into my production web app?
      - Can I trigger a repository sync on the main app manually?
      instructions:
      - text: Sync web app {app} in {rg} (subscription {sub}) with its repository.
        slots:
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Pull the latest repo changes into production app {app}.
        slots:
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/sync'].post
  update:
    x-apievangelist-phrasing:
      intent: Sync a slot with its repository
      effect: write
      questions:
      - Can I trigger a repository sync for a staging slot?
      - How do I redeploy a deployment slot from its connected repo?
      instructions:
      - text: Sync non-production slot {slot} of web app {app} in {rg} (subscription {sub}) with its repository.
        slots:
          slot: path.slot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Pull the latest repo changes into deployment slot {slot} of {app}.
        slots:
          slot: path.slot
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/newpassword'].post
  update:
    x-apievangelist-phrasing:
      intent: Regenerate a slot's publishing password
      effect: destructive
      questions:
      - How do I rotate the deployment password for a staging slot?
      - Will generating a new publishing password break existing slot deploy scripts?
      instructions:
      - text: Generate a new publishing password for non-production slot {slot} of app {app} in {rg} (subscription {sub}).
        slots:
          slot: path.slot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Rotate deployment slot {slot} of {app}'s publish password.
        slots:
          slot: path.slot
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/newpassword'].post
  update:
    x-apievangelist-phrasing:
      intent: Regenerate a web app's publishing password
      effect: destructive
      questions:
      - How do I rotate the publishing password on my production web app?
      - Can I invalidate leaked deployment credentials for the main app?
      instructions:
      - text: Generate a new publishing password for web app {app} in {rg} (subscription {sub}).
        slots:
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Rotate production app {app}'s publish password.
        slots:
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/hybridconnection/{entityName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a web app's BizTalk hybrid connection
      effect: read
      questions:
      - How do I look up one BizTalk hybrid connection on my production web app?
      - What endpoint does a named hybrid connection on the main app point to?
      instructions:
      - text: Get hybrid connection {entity} on web app {app} in {rg} (subscription {sub}).
        slots:
          entity: path.entityName
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show production app {app}'s BizTalk hybrid connection {entity}.
        slots:
          app: path.name
          entity: path.entityName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/hybridconnection/{entityName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Add a BizTalk hybrid connection to a web app
      effect: write
      questions:
      - How do I associate a BizTalk hybrid connection with my production web app?
      - Can I replace an existing hybrid connection on the main app in one call?
      instructions:
      - text: Create hybrid connection {entity} on web app {app} in {rg} (subscription {sub}), location {location}.
        slots:
          entity: path.entityName
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
          location: requestBody.location
      - text: Create or replace production app {app}'s BizTalk hybrid connection {entity}.
        slots:
          app: path.name
          entity: path.entityName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/hybridconnection/{entityName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a web app's BizTalk hybrid connection
      effect: destructive
      questions:
      - How do I remove a BizTalk hybrid connection from my production web app?
      - Will deleting a hybrid connection cut the main app off from on-premises resources?
      instructions:
      - text: Delete hybrid connection {entity} from web app {app} in {rg} (subscription {sub}).
        slots:
          entity: path.entityName
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Remove production app {app}'s BizTalk hybrid connection {entity}.
        slots:
          app: path.name
          entity: path.entityName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/hybridconnection/{entityName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Patch a web app's BizTalk hybrid connection
      effect: write
      questions:
      - Can I partially update a BizTalk hybrid connection on my production app?
      - Is there a PATCH for the main app's existing hybrid connection?
      instructions:
      - text: Patch hybrid connection {entity} on web app {app} in {rg} (subscription {sub}), location {location}.
        slots:
          entity: path.entityName
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
          location: requestBody.location
      - text: Partially update production app {app}'s existing BizTalk connection {entity}.
        slots:
          app: path.name
          entity: path.entityName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/hybridconnection/{entityName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a slot's BizTalk hybrid connection
      effect: read
      questions:
      - Can I look up a BizTalk hybrid connection on a deployment slot?
      - What does the named hybrid connection on my staging slot point to?
      instructions:
      - text: Get hybrid connection {entity} on non-production slot {slot} of web app {app} in {rg} (subscription {sub}).
        slots:
          entity: path.entityName
          slot: path.slot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show deployment slot {slot} of {app}'s BizTalk hybrid connection {entity}.
        slots:
          slot: path.slot
          app: path.name
          entity: path.entityName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/hybridconnection/{entityName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Add a BizTalk hybrid connection to a slot
      effect: write
      questions:
      - How do I give a staging slot its own BizTalk hybrid connection?
      - Can a hybrid connection be created on a deployment slot rather than production?
      instructions:
      - text: Create hybrid connection {entity} on non-production slot {slot} of app {app} in {rg} (subscription {sub}), location {location}.
        slots:
          entity: path.entityName
          slot: path.slot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
          location: requestBody.location
      - text: Create or replace deployment slot {slot} of {app}'s BizTalk connection {entity}.
        slots:
          slot: path.slot
          app: path.name
          entity: path.entityName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/hybridconnection/{entityName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a slot's BizTalk hybrid connection
      effect: destructive
      questions:
      - How do I remove a BizTalk hybrid connection from a deployment slot?
      - Can I drop a staging slot's hybrid connection without affecting production?
      instructions:
      - text: Delete hybrid connection {entity} from non-production slot {slot} of web app {app} in {rg} (subscription {sub}).
        slots:
          entity: path.entityName
          slot: path.slot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Remove deployment slot {slot} of {app}'s BizTalk hybrid connection {entity}.
        slots:
          slot: path.slot
          app: path.name
          entity: path.entityName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/hybridconnection/{entityName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Patch a slot's BizTalk hybrid connection
      effect: write
      questions:
      - Can I partially update a hybrid connection on a staging slot?
      - Is there a PATCH for a deployment slot's BizTalk connection?
      instructions:
      - text: Patch hybrid connection {entity} on non-production slot {slot} of web app {app} in {rg} (subscription {sub}), location {location}.
        slots:
          entity: path.entityName
          slot: path.slot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
          location: requestBody.location
      - text: Partially update deployment slot {slot} of {app}'s existing BizTalk connection {entity}.
        slots:
          slot: path.slot
          app: path.name
          entity: path.entityName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/hybridconnection'].get
  update:
    x-apievangelist-phrasing:
      intent: List a slot's BizTalk hybrid connections
      effect: read
      questions:
      - Which BizTalk hybrid connections does my staging slot have?
      - Can I list all hybrid connections on one deployment slot?
      instructions:
      - text: List hybrid connections of non-production slot {slot} of web app {app} in {rg} (subscription {sub}).
        slots:
          slot: path.slot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show every BizTalk connection on deployment slot {slot} of {app}.
        slots:
          slot: path.slot
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/hybridconnection'].get
  update:
    x-apievangelist-phrasing:
      intent: List a web app's BizTalk hybrid connections
      effect: read
      questions:
      - What BizTalk hybrid connections are attached to my production web app?
      - Can I list every hybrid connection on the main app?
      instructions:
      - text: List hybrid connections of web app {app} in {rg} (subscription {sub}).
        slots:
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show every BizTalk connection on production app {app}.
        slots:
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/virtualNetworkConnections/{vnetName}/gateways/{gatewayName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a slot's VNet connection gateway
      effect: read
      questions:
      - How do I see the gateway behind a deployment slot's VNet connection?
      - What VPN package does a staging slot's virtual network gateway use?
      instructions:
      - text: Get gateway {gateway} of VNet {vnet} on non-production slot {slot} of app {app} in {rg} (subscription {sub}).
        slots:
          gateway: path.gatewayName
          vnet: path.vnetName
          slot: path.slot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show deployment slot {slot} of {app}'s network gateway {gateway} for {vnet}.
        slots:
          slot: path.slot
          app: path.name
          gateway: path.gatewayName
          vnet: path.vnetName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/virtualNetworkConnections/{vnetName}/gateways/{gatewayName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Set a slot's VNet connection gateway
      effect: write
      questions:
      - Can I configure the gateway for a deployment slot's virtual network link?
      - How do I replace the VNet gateway settings on a staging slot?
      instructions:
      - text: Set gateway {gateway} for VNet {vnet} on non-production slot {slot} of app {app} in {rg} (subscription {sub}), location {location}.
        slots:
          gateway: path.gatewayName
          vnet: path.vnetName
          slot: path.slot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
          location: requestBody.location
      - text: Create or replace deployment slot {slot} of {app}'s {vnet} gateway {gateway}.
        slots:
          slot: path.slot
          app: path.name
          vnet: path.vnetName
          gateway: path.gatewayName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/virtualNetworkConnections/{vnetName}/gateways/{gatewayName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Patch a slot's VNet connection gateway
      effect: write
      questions:
      - Is there a partial update for a staging slot's virtual network gateway?
      - Can I patch one field on a deployment slot's VNet gateway?
      instructions:
      - text: Partially modify existing gateway {gateway} for VNet {vnet} on non-production slot {slot} of app {app} in {rg} (subscription {sub}), location {location}.
        slots:
          gateway: path.gatewayName
          vnet: path.vnetName
          slot: path.slot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
          location: requestBody.location
      - text: Partially update deployment slot {slot} of {app}'s existing {vnet} gateway {gateway}.
        slots:
          slot: path.slot
          app: path.name
          vnet: path.vnetName
          gateway: path.gatewayName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/virtualNetworkConnections/{vnetName}/gateways/{gatewayName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a web app's VNet connection gateway
      effect: read
      questions:
      - How do I inspect the gateway used by my production app's VNet connection?
      - Which VPN package URL does the main app's virtual network gateway have?
      instructions:
      - text: Get gateway {gateway} of VNet {vnet} on web app {app} in {rg} (subscription {sub}).
        slots:
          gateway: path.gatewayName
          vnet: path.vnetName
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show production app {app}'s network gateway {gateway} for {vnet}.
        slots:
          app: path.name
          gateway: path.gatewayName
          vnet: path.vnetName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/virtualNetworkConnections/{vnetName}/gateways/{gatewayName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Set a web app's VNet connection gateway
      effect: write
      questions:
      - How do I configure the gateway for my production web app's VNet connection?
      - Can the main app's virtual network gateway settings be replaced?
      instructions:
      - text: Set gateway {gateway} for VNet {vnet} on web app {app} in {rg} (subscription {sub}), location {location}.
        slots:
          gateway: path.gatewayName
          vnet: path.vnetName
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
          location: requestBody.location
      - text: Create or replace production app {app}'s {vnet} gateway {gateway}.
        slots:
          app: path.name
          vnet: path.vnetName
          gateway: path.gatewayName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/virtualNetworkConnections/{vnetName}/gateways/{gatewayName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Patch a web app's VNet connection gateway
      effect: write
      questions:
      - Can I patch the gateway on my production app's virtual network link?
      - Is a partial update of the main app's VNet gateway supported?
      instructions:
      - text: Patch gateway {gateway} for VNet {vnet} on web app {app} in {rg} (subscription {sub}), location {location}.
        slots:
          gateway: path.gatewayName
          vnet: path.vnetName
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
          location: requestBody.location
      - text: Partially update production app {app}'s existing {vnet} gateway {gateway}.
        slots:
          app: path.name
          vnet: path.vnetName
          gateway: path.gatewayName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/virtualNetworkConnections'].get
  update:
    x-apievangelist-phrasing:
      intent: List a web app's VNet connections
      effect: read
      questions:
      - Which virtual networks is my production web app connected to?
      - Can I list every VNet integration on the main app?
      instructions:
      - text: List virtual network connections of web app {app} in {rg} (subscription {sub}).
        slots:
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show all VNets linked to production app {app}.
        slots:
          app: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/virtualNetworkConnections'].get
  update:
    x-apievangelist-phrasing:
      intent: List a slot's VNet connections
      effect: read
      questions:
      - What virtual networks is my staging slot connected to?
      - Can I list all VNet links for one deployment slot?
      instructions:
      - text: List virtual network connections of non-production slot {slot} of web app {app} in {rg} (subscription {sub}).
        slots:
          slot: path.slot
          app: path.name
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show all VNets linked to deployment slot {slot} of {app}.
        slots:
          slot: path.slot
          app: path.name
      method: generated
      generated: '2026-09-26'