# 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 Domain API
  version: 1.0.0
extends: openapi/microsoft-azure-domain-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: 4
- target: $.paths['/domains/{domainName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a domain in the account
      effect: read
      questions:
      - What are the details of one domain registered in my account?
      - Can I look up an account domain directly by its name?
      instructions:
      - text: Get account domain {domain}.
        slots:
          domain: path.domainName
      - text: Show the settings of domain {domain} in my account.
        slots:
          domain: path.domainName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/domains'].get
  update:
    x-apievangelist-phrasing:
      intent: List the domains in the account
      effect: read
      questions:
      - Which domains are set up in my account?
      - Can I page through the account's domain list with a skip token?
      instructions:
      - text: List all domains in my account.
      - text: Continue listing account domains from skip token {token}.
        slots:
          token: query.$skipToken
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{tenantID}/domains'].get
  update:
    x-apievangelist-phrasing:
      intent: List domains for a directory tenant
      effect: read
      questions:
      - Which domains are verified in my directory tenant?
      - Can I filter the tenant's domain list?
      instructions:
      - text: List domains in tenant {tenant}.
        slots:
          tenant: path.tenantID
      - text: Show tenant {tenant} domains matching {filter}.
        slots:
          tenant: path.tenantID
          filter: query.$filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{tenantID}/domains/{domainName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a specific domain in a directory tenant
      effect: read
      questions:
      - Is a particular domain registered in my directory tenant?
      - What does the tenant record for one domain look like?
      instructions:
      - text: Get domain {domain} in tenant {tenant}.
        slots:
          domain: path.domainName
          tenant: path.tenantID
      - text: Show the directory tenant {tenant} entry for {domain}.
        slots:
          tenant: path.tenantID
          domain: path.domainName
      method: generated
      generated: '2026-09-26'