# 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 Global API
  version: 1.0.0
extends: openapi/microsoft-azure-global-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: 16
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Web/deletedSites/{deletedSiteId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a deleted web app in a subscription
      effect: read
      questions:
      - Can I see the details of an App Service web app that was deleted?
      - What information is kept about a deleted site in my subscription?
      instructions:
      - text: Get deleted web app {deleted_site_id} in subscription {subscription}.
        slots:
          deleted_site_id: path.deletedSiteId
          subscription: path.subscriptionId
      - text: Look up the deleted site {deleted_site_id}.
        slots:
          deleted_site_id: path.deletedSiteId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Web/deletedSites/{deletedSiteId}/snapshots'].get
  update:
    x-apievangelist-phrasing:
      intent: List snapshots of a deleted web app
      effect: read
      questions:
      - Which snapshots are still available for a web app I deleted?
      - Can I find restore points for a deleted App Service site?
      instructions:
      - text: List snapshots for deleted web app {deleted_site_id} in subscription {subscription}.
        slots:
          deleted_site_id: path.deletedSiteId
          subscription: path.subscriptionId
      - text: Show restore snapshots of deleted site {deleted_site_id}.
        slots:
          deleted_site_id: path.deletedSiteId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Web/locations/{location}/operations/{operationId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check an App Service operation in a region
      effect: read
      questions:
      - How do I check the status of a long-running App Service operation in a region?
      - Has an asynchronous web app operation in a given location completed?
      instructions:
      - text: Get App Service operation {operation_id} in {location} for subscription {subscription}.
        slots:
          operation_id: path.operationId
          location: path.location
          subscription: path.subscriptionId
      - text: Check whether operation {operation_id} in region {location} has finished.
        slots:
          operation_id: path.operationId
          location: path.location
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Web/publishingCredentials'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the subscription's publishing credentials
      effect: read
      questions:
      - What deployment user credentials does my subscription owner have for App Service?
      - Where do I find the publishing username used to deploy web apps?
      instructions:
      - text: Get the publishing credentials for subscription {subscription}.
        slots:
          subscription: path.subscriptionId
      - text: Show my App Service deployment user for subscription {subscription}.
        slots:
          subscription: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Web/publishingCredentials'].put
  update:
    x-apievangelist-phrasing:
      intent: Update the subscription's publishing credentials
      effect: write
      questions:
      - How do I change the deployment credentials used to publish my web apps?
      - Can I reset the subscription-level publishing user for App Service?
      instructions:
      - text: Update the publishing credentials for subscription {subscription} in {location}.
        slots:
          subscription: path.subscriptionId
          location: requestBody.location
      - text: Set new deployment credentials {properties} for subscription {subscription}.
        slots:
          properties: requestBody.properties
          subscription: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Web/geoRegions'].get
  update:
    x-apievangelist-phrasing:
      intent: List App Service geographical regions
      effect: read
      questions:
      - Which geographical regions can host App Service plans for a given SKU?
      - Can I list only regions that support Linux workers for App Service?
      instructions:
      - text: List App Service geo regions that support the {sku} SKU in subscription {subscriptionId}.
        slots:
          sku: query.sku
          subscriptionId: path.subscriptionId
      - text: Show App Service regions where Linux workers enabled is {linuxWorkersEnabled}.
        slots:
          linuxWorkersEnabled: query.linuxWorkersEnabled
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Web/certificates'].get
  update:
    x-apievangelist-phrasing:
      intent: List App Service certificates in a subscription
      effect: read
      questions:
      - Which TLS certificates are uploaded to App Service across my subscription?
      - Can I see every web app certificate I own in one list?
      instructions:
      - text: List all App Service certificates in subscription {subscription}.
        slots:
          subscription: path.subscriptionId
      - text: Show every SSL certificate for web apps under subscription {subscription}.
        slots:
          subscription: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Web/serverfarms'].get
  update:
    x-apievangelist-phrasing:
      intent: List App Service plans in a subscription
      effect: read
      questions:
      - Which App Service plans exist across my subscription?
      - Can I get full details on each server farm instead of the short list?
      instructions:
      - text: List all App Service plans in subscription {subscription}.
        slots:
          subscription: path.subscriptionId
      - text: List App Service plans in subscription {subscription} with detailed output set to {detailed}.
        slots:
          subscription: path.subscriptionId
          detailed: query.detailed
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Web/sites'].get
  update:
    x-apievangelist-phrasing:
      intent: List all web apps in a subscription
      effect: read
      questions:
      - What web apps are running in my subscription?
      - Can I get every App Service site across all resource groups at once?
      instructions:
      - text: List all web apps in subscription {subscription}.
        slots:
          subscription: path.subscriptionId
      - text: Show every App Service site I have under subscription {subscription}.
        slots:
          subscription: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Web/hostingEnvironments'].get
  update:
    x-apievangelist-phrasing:
      intent: List App Service Environments in a subscription
      effect: read
      questions:
      - Which App Service Environments are deployed in my subscription?
      - Can I see all my isolated hosting environments in one call?
      instructions:
      - text: List all App Service Environments in subscription {subscription}.
        slots:
          subscription: path.subscriptionId
      - text: Show the hosting environments (ASEs) under subscription {subscription}.
        slots:
          subscription: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Web/managedHostingEnvironments'].get
  update:
    x-apievangelist-phrasing:
      intent: List managed hosting environments
      effect: read
      questions:
      - Which managed hosting environments does my subscription have?
      - Are there any managed App Service hosting environments I am paying for?
      instructions:
      - text: List managed hosting environments in subscription {subscription}.
        slots:
          subscription: path.subscriptionId
      - text: Show every managed hosting environment for subscription {subscription}.
        slots:
          subscription: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Web/classicMobileServices'].get
  update:
    x-apievangelist-phrasing:
      intent: List classic mobile services
      effect: read
      questions:
      - Do I still have any classic mobile services in my subscription?
      - Which legacy mobile services are left to migrate?
      instructions:
      - text: List classic mobile services in subscription {subscription}.
        slots:
          subscription: path.subscriptionId
      - text: Show all legacy mobile services under subscription {subscription}.
        slots:
          subscription: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Web/premieraddonoffers'].get
  update:
    x-apievangelist-phrasing:
      intent: List premier add-on offers
      effect: read
      questions:
      - Which premier add-on offers can I attach to my web apps?
      - What third-party premier add-ons are available in App Service?
      instructions:
      - text: List premier add-on offers for subscription {subscription}.
        slots:
          subscription: path.subscriptionId
      - text: Show the premier add-ons I can buy under subscription {subscription}.
        slots:
          subscription: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Web/ishostingenvironmentnameavailable'].get
  update:
    x-apievangelist-phrasing:
      intent: Check if a hosting environment name is free
      effect: read
      questions:
      - Is the name I want for a new App Service Environment still available?
      - Can I check an ASE name using a query parameter before creating it?
      instructions:
      - text: Check whether hosting environment name {name} is available in subscription {subscription}.
        slots:
          name: query.name
          subscription: path.subscriptionId
      - text: See if I can still use {name} as an App Service Environment name.
        slots:
          name: query.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Web/ishostingenvironmentnameavailable/{name}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check a hosting environment name (legacy path)
      effect: read
      questions:
      - Is there an older endpoint that checks an ASE name passed in the URL path?
      - Can I verify a legacy hosting environment name through the path-based check?
      instructions:
      - text: Use the legacy path check to see if hosting environment name {name} is available in subscription {subscription}.
        slots:
          name: path.name
          subscription: path.subscriptionId
      - text: Run the older name-in-path availability check for ASE {name}.
        slots:
          name: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Web/checknameavailability'].post
  update:
    x-apievangelist-phrasing:
      intent: Check if an App Service resource name is available
      effect: read
      questions:
      - Is a web app or App Service plan name already taken?
      - Can I check whether a fully qualified hostname is free before creating a site?
      instructions:
      - text: Check if resource name {name} of type {type} is available in subscription {subscription}.
        slots:
          name: requestBody.name
          type: requestBody.type
          subscription: path.subscriptionId
      - text: Verify that {name} is free, treating it as a fully qualified domain name ({is_fqdn}).
        slots:
          name: requestBody.name
          is_fqdn: requestBody.isFqdn
      method: generated
      generated: '2026-09-26'