# 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 Top Level Domains…
  version: 1.0.0
extends: openapi/microsoft-azure-topleveldomains-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: 3
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.DomainRegistration/topLevelDomains'].get
  update:
    x-apievangelist-phrasing:
      intent: List top-level domains for App Service Domains
      effect: read
      questions:
      - Which top-level domains can I register with App Service Domains?
      - What TLDs does Azure domain registration support?
      instructions:
      - text: List all top-level domains available for registration in subscription {subscriptionId}.
        slots:
          subscriptionId: path.subscriptionId
      - text: Show every TLD supported by App Service Domains.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.DomainRegistration/topLevelDomains/{name}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a top-level domain
      effect: read
      questions:
      - Does App Service Domains support a particular TLD like .io?
      - Is privacy protection available for a given top-level domain?
      instructions:
      - text: Get top-level domain {name} for subscription {subscriptionId}.
        slots:
          name: path.name
          subscriptionId: path.subscriptionId
      - text: Show details of TLD {name}.
        slots:
          name: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.DomainRegistration/topLevelDomains/{name}/listAgreements'].post
  update:
    x-apievangelist-phrasing:
      intent: List legal agreements for a top-level domain
      effect: read
      questions:
      - What legal agreements must I accept to register a domain under a TLD?
      - Can I include the privacy agreement when listing TLD terms?
      instructions:
      - text: List agreements for top-level domain {name} in subscription {subscriptionId}.
        slots:
          name: path.name
          subscriptionId: path.subscriptionId
      - text: Show {name} registration agreements with privacy set to {includePrivacy}.
        slots:
          name: path.name
          includePrivacy: requestBody.includePrivacy
      method: generated
      generated: '2026-09-26'