# 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 Global Domain…
  version: 1.0.0
extends: openapi/microsoft-azure-globaldomainregistration-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 5
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.DomainRegistration/domains'].get
  update:
    x-apievangelist-phrasing:
      intent: List all App Service domains in a subscription
      effect: read
      questions:
      - Which domains have I registered through Azure App Service?
      - Can I see every purchased domain in my subscription?
      instructions:
      - text: List all registered domains in subscription {subscriptionId}.
        slots:
          subscriptionId: path.subscriptionId
      - text: Show my App Service domains using API version {apiVersion}.
        slots:
          apiVersion: query.api-version
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.DomainRegistration/generateSsoRequest'].post
  update:
    x-apievangelist-phrasing:
      intent: Generate SSO request for the domain portal
      effect: write
      questions:
      - How do I sign in to the domain management control center from Azure?
      - Can I get a single sign-on link to manage my domain's DNS settings?
      instructions:
      - text: Generate a single sign-on request for the domain control center in subscription {subscriptionId}.
        slots:
          subscriptionId: path.subscriptionId
      - text: Create a domain portal SSO request with API version {apiVersion}.
        slots:
          apiVersion: query.api-version
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.DomainRegistration/validateDomainRegistrationInformation'].post
  update:
    x-apievangelist-phrasing:
      intent: Validate domain registration details
      effect: read
      questions:
      - Will my domain purchase details pass validation before I buy?
      - Can I check registration contact info without actually registering the domain?
      instructions:
      - text: Validate domain registration information for location {location} in subscription {subscriptionId}.
        slots:
          location: requestBody.location
          subscriptionId: path.subscriptionId
      - text: Check domain purchase details {properties} located in {location}.
        slots:
          properties: requestBody.properties
          location: requestBody.location
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.DomainRegistration/checkDomainAvailability'].post
  update:
    x-apievangelist-phrasing:
      intent: Check if a domain is available to register
      effect: read
      questions:
      - Is the domain name I want available for purchase?
      - Can I check domain availability before starting a registration?
      instructions:
      - text: Check whether domain {name} is available.
        slots:
          name: requestBody.name
      - text: See if {name} can be registered in subscription {subscriptionId}.
        slots:
          name: requestBody.name
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.DomainRegistration/listDomainRecommendations'].post
  update:
    x-apievangelist-phrasing:
      intent: Get domain name suggestions from keywords
      effect: read
      questions:
      - Can Azure suggest available domain names based on keywords?
      - How many domain recommendations can I ask for at once?
      instructions:
      - text: Recommend domain names for keywords {keywords}.
        slots:
          keywords: requestBody.keywords
      - text: Suggest up to {max} domains for {keywords} in subscription {subscriptionId}.
        slots:
          max: requestBody.maxDomainRecommendations
          keywords: requestBody.keywords
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'