# 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 Domains API
  version: 1.0.0
extends: openapi/microsoft-azure-domains-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: 25
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.DomainRegistration/checkDomainAvailability'].post
  update:
    x-apievangelist-phrasing:
      intent: Check whether a domain name can be registered
      effect: read
      questions:
      - Is a domain name still available to buy through App Service domains?
      - Can I check if a domain is free for registration before purchasing it?
      instructions:
      - text: Check if a domain name is available to register under subscription {subscription}.
        slots:
          subscription: path.subscriptionId
      - text: See whether my desired domain can still be registered in Azure.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.DomainRegistration/domains'].get
  update:
    x-apievangelist-phrasing:
      intent: List all registered App Service domains
      effect: read
      questions:
      - Which App Service domains have I purchased across my whole subscription?
      - How do I see every domain I registered through Azure in one subscription?
      instructions:
      - text: List every App Service domain registered in subscription {subscription}.
        slots:
          subscription: path.subscriptionId
      - text: Show all the domain names I bought in Azure.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.DomainRegistration/generateSsoRequest'].post
  update:
    x-apievangelist-phrasing:
      intent: Get single sign-on to the domain management portal
      effect: read
      questions:
      - Can I sign in to the domain management control center without a separate login?
      - What do I need to open the registrar portal for my purchased domains with SSO?
      instructions:
      - text: Generate a single sign-on request for the domain management portal in subscription {subscription}.
        slots:
          subscription: path.subscriptionId
      - text: Give me an SSO link into the domain control center.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.DomainRegistration/listDomainRecommendations'].post
  update:
    x-apievangelist-phrasing:
      intent: Suggest domain names from keywords
      effect: read
      questions:
      - Can Azure suggest available domain names based on a few keywords?
      - Is there a way to limit how many domain name suggestions come back?
      instructions:
      - text: Recommend domain names for the keywords {keywords}.
        slots:
          keywords: requestBody.keywords
      - text: Suggest up to {max} domain names based on {keywords} in subscription {subscription}.
        slots:
          max: requestBody.maxDomainRecommendations
          keywords: requestBody.keywords
          subscription: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DomainRegistration/domains'].get
  update:
    x-apievangelist-phrasing:
      intent: List registered domains in a resource group
      effect: read
      questions:
      - Which purchased App Service domains live in a particular resource group?
      - Can I list only the registered domains in one resource group rather than the whole subscription?
      instructions:
      - text: List the App Service domains registered in resource group {resource_group}.
        slots:
          resource_group: path.resourceGroupName
      - text: Show registered domains in resource group {resource_group} of subscription {subscription}.
        slots:
          subscription: path.subscriptionId
          resource_group: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DomainRegistration/domains/{domainName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a registered App Service domain
      effect: read
      questions:
      - What are the registration details and status of a domain I bought through Azure?
      - Where can I see the expiry and contact settings of my purchased domain?
      instructions:
      - text: Get the registration details of App Service domain {domain} in resource group {resource_group}.
        slots:
          domain: path.domainName
          resource_group: path.resourceGroupName
      - text: Show purchased domain {domain} in subscription {subscription}, resource group {resource_group}.
        slots:
          subscription: path.subscriptionId
          resource_group: path.resourceGroupName
          domain: path.domainName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DomainRegistration/domains/{domainName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Purchase or replace an App Service domain
      effect: write
      questions:
      - How do I buy a new domain name through Azure App Service?
      - Can I register a domain and set its contact details in one request?
      instructions:
      - text: Register the App Service domain {domain} in resource group {resource_group}.
        slots:
          domain: path.domainName
          resource_group: path.resourceGroupName
      - text: Purchase domain {domain} in subscription {subscription}, resource group {resource_group}, with these registration properties.
        slots:
          subscription: path.subscriptionId
          resource_group: path.resourceGroupName
          domain: path.domainName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DomainRegistration/domains/{domainName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a registered App Service domain
      effect: destructive
      questions:
      - Can I remove a purchased domain from my Azure subscription?
      - Is it possible to force a hard delete of a registered domain?
      instructions:
      - text: Delete the App Service domain {domain} from resource group {resource_group}.
        slots:
          domain: path.domainName
          resource_group: path.resourceGroupName
      - text: Hard delete registered domain {domain} in subscription {subscription}, resource group {resource_group}, with force set to {force}.
        slots:
          subscription: path.subscriptionId
          resource_group: path.resourceGroupName
          domain: path.domainName
          force: query.forceHardDeleteDomain
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DomainRegistration/domains/{domainName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Patch settings on a registered App Service domain
      effect: write
      questions:
      - Can I change auto-renew or privacy on a domain I already bought?
      - What properties of an existing purchased domain can I patch in place?
      instructions:
      - text: Patch the settings of my existing App Service domain {domain} in resource group {resource_group}.
        slots:
          domain: path.domainName
          resource_group: path.resourceGroupName
      - text: Turn on auto-renew for purchased domain {domain} in subscription {subscription}, resource group {resource_group}.
        slots:
          subscription: path.subscriptionId
          resource_group: path.resourceGroupName
          domain: path.domainName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DomainRegistration/domains/{domainName}/domainOwnershipIdentifiers'].get
  update:
    x-apievangelist-phrasing:
      intent: List ownership identifiers for a domain
      effect: read
      questions:
      - Which ownership identifiers are attached to my purchased domain?
      - Can I see all the domain verification identifiers on one registered domain?
      instructions:
      - text: List the ownership identifiers on domain {domain} in resource group {resource_group}.
        slots:
          domain: path.domainName
          resource_group: path.resourceGroupName
      - text: Show every ownership identifier for registered domain {domain} in subscription {subscription}, resource group {resource_group}.
        slots:
          subscription: path.subscriptionId
          resource_group: path.resourceGroupName
          domain: path.domainName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DomainRegistration/domains/{domainName}/domainOwnershipIdentifiers/{name}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one domain ownership identifier
      effect: read
      questions:
      - What value does a specific ownership identifier on my domain hold?
      - Where do I look up a single named ownership identifier for a registered domain?
      instructions:
      - text: Get ownership identifier {name} on domain {domain}.
        slots:
          name: path.name
          domain: path.domainName
      - text: Show ownership identifier {name} for domain {domain} in subscription {subscription}, resource group {resource_group}.
        slots:
          subscription: path.subscriptionId
          resource_group: path.resourceGroupName
          domain: path.domainName
          name: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DomainRegistration/domains/{domainName}/domainOwnershipIdentifiers/{name}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or replace a domain ownership identifier
      effect: write
      questions:
      - How do I add an ownership identifier to a domain I purchased?
      - Can I create a new named ownership identifier or overwrite one with a PUT?
      instructions:
      - text: Create ownership identifier {name} on domain {domain}.
        slots:
          name: path.name
          domain: path.domainName
      - text: Put ownership identifier {name} for domain {domain} in subscription {subscription}, resource group {resource_group}.
        slots:
          subscription: path.subscriptionId
          resource_group: path.resourceGroupName
          domain: path.domainName
          name: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DomainRegistration/domains/{domainName}/domainOwnershipIdentifiers/{name}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a domain ownership identifier
      effect: destructive
      questions:
      - Can I remove an ownership identifier I no longer need from a domain?
      - What happens if I delete a stale ownership identifier from a registered domain?
      instructions:
      - text: Delete ownership identifier {name} from domain {domain}.
        slots:
          name: path.name
          domain: path.domainName
      - text: Remove ownership identifier {name} on domain {domain} in subscription {subscription}, resource group {resource_group}.
        slots:
          subscription: path.subscriptionId
          resource_group: path.resourceGroupName
          domain: path.domainName
          name: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DomainRegistration/domains/{domainName}/domainOwnershipIdentifiers/{name}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Patch an existing domain ownership identifier
      effect: write
      questions:
      - Can I change the value of an ownership identifier that already exists on my domain?
      - Is there a partial update for an existing domain ownership identifier?
      instructions:
      - text: Patch the existing ownership identifier {name} on domain {domain}.
        slots:
          name: path.name
          domain: path.domainName
      - text: Update the value of ownership identifier {name} already on domain {domain} in subscription {subscription}, group {resource_group}.
        slots:
          subscription: path.subscriptionId
          resource_group: path.resourceGroupName
          domain: path.domainName
          name: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DomainRegistration/domains/{domainName}/renew'].post
  update:
    x-apievangelist-phrasing:
      intent: Renew a registered domain
      effect: write
      questions:
      - How do I renew a domain name before it expires?
      - Can I manually trigger renewal of a purchased App Service domain?
      instructions:
      - text: Renew the domain {domain} in resource group {resource_group}.
        slots:
          domain: path.domainName
          resource_group: path.resourceGroupName
      - text: Extend the registration of domain {domain} in subscription {subscription}, resource group {resource_group} now.
        slots:
          subscription: path.subscriptionId
          resource_group: path.resourceGroupName
          domain: path.domainName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DomainRegistration/domains/{domainName}/transferOut'].put
  update:
    x-apievangelist-phrasing:
      intent: Transfer a domain out to another registrar
      effect: destructive
      questions:
      - How do I move a domain I bought in Azure to a different registrar?
      - Can I start a transfer-out for my purchased domain?
      instructions:
      - text: Transfer domain {domain} out of Azure to another registrar.
        slots:
          domain: path.domainName
      - text: Start a transfer-out for domain {domain} in subscription {subscription}, resource group {resource_group}.
        slots:
          subscription: path.subscriptionId
          resource_group: path.resourceGroupName
          domain: path.domainName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/domains/{domainName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an Event Grid domain
      effect: read
      questions:
      - What are the properties of an Event Grid domain I set up for publishing events?
      - Where can I see the endpoint and provisioning state of an Event Grid domain?
      instructions:
      - text: Get Event Grid domain {domain} in resource group {resource_group}.
        slots:
          domain: path.domainName
          resource_group: path.resourceGroupName
      - text: Show properties of Event Grid domain {domain} in subscription {subscription}, resource group {resource_group}.
        slots:
          subscription: path.subscriptionId
          resource_group: path.resourceGroupName
          domain: path.domainName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/domains/{domainName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or replace an Event Grid domain
      effect: write
      questions:
      - How do I create an Event Grid domain to manage many topics?
      - Which settings like SKU, identity and location can I give a new Event Grid domain?
      instructions:
      - text: Create Event Grid domain {domain} in {location} under resource group {resource_group}.
        slots:
          domain: path.domainName
          location: requestBody.location
          resource_group: path.resourceGroupName
      - text: Create or replace Event Grid domain {domain} in subscription {subscription}, resource group {resource_group}.
        slots:
          subscription: path.subscriptionId
          resource_group: path.resourceGroupName
          domain: path.domainName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/domains/{domainName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an Event Grid domain
      effect: destructive
      questions:
      - Can I tear down an Event Grid domain I no longer publish to?
      - What gets removed when I delete an Event Grid domain?
      instructions:
      - text: Delete Event Grid domain {domain} from resource group {resource_group}.
        slots:
          domain: path.domainName
          resource_group: path.resourceGroupName
      - text: Remove Event Grid domain {domain} in subscription {subscription}, resource group {resource_group}.
        slots:
          subscription: path.subscriptionId
          resource_group: path.resourceGroupName
          domain: path.domainName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/domains/{domainName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an Event Grid domain
      effect: write
      questions:
      - Can I change the tags or SKU on an existing Event Grid domain?
      - Is it possible to add a managed identity to an Event Grid domain after creating it?
      instructions:
      - text: Update tags on Event Grid domain {domain} to {tags}.
        slots:
          domain: path.domainName
          tags: requestBody.tags
      - text: Change the SKU of Event Grid domain {domain} in subscription {subscription}, resource group {resource_group}.
        slots:
          subscription: path.subscriptionId
          resource_group: path.resourceGroupName
          domain: path.domainName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.EventGrid/domains'].get
  update:
    x-apievangelist-phrasing:
      intent: List Event Grid domains in a subscription
      effect: read
      questions:
      - Which Event Grid domains exist across my Azure subscription?
      - Can I filter or cap the number of Event Grid domains returned for a subscription?
      instructions:
      - text: List all Event Grid domains in subscription {subscription}.
        slots:
          subscription: path.subscriptionId
      - text: List the first {top} Event Grid domains in my subscription matching {filter}.
        slots:
          top: query.$top
          filter: query.$filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/domains'].get
  update:
    x-apievangelist-phrasing:
      intent: List Event Grid domains in a resource group
      effect: read
      questions:
      - What Event Grid domains are in a single resource group?
      - Can I filter Event Grid domains by name within one resource group?
      instructions:
      - text: List Event Grid domains in resource group {resource_group}.
        slots:
          resource_group: path.resourceGroupName
      - text: Show Event Grid domains in subscription {subscription}, resource group {resource_group} whose name matches {filter}.
        slots:
          subscription: path.subscriptionId
          resource_group: path.resourceGroupName
          filter: query.$filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/domains/{domainName}/listKeys'].post
  update:
    x-apievangelist-phrasing:
      intent: Get the publishing keys for an Event Grid domain
      effect: read
      questions:
      - Where do I find the access keys to publish events to an Event Grid domain?
      - What are the two shared access keys on my Event Grid domain?
      instructions:
      - text: Show the shared access keys for Event Grid domain {domain}.
        slots:
          domain: path.domainName
      - text: List publish keys of Event Grid domain {domain} in subscription {subscription}, resource group {resource_group}.
        slots:
          subscription: path.subscriptionId
          resource_group: path.resourceGroupName
          domain: path.domainName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/domains/{domainName}/regenerateKey'].post
  update:
    x-apievangelist-phrasing:
      intent: Regenerate an Event Grid domain access key
      effect: destructive
      questions:
      - How do I rotate a leaked publishing key on an Event Grid domain?
      - Can I regenerate just key1 or key2 of an Event Grid domain?
      instructions:
      - text: Regenerate {key_name} on Event Grid domain {domain}.
        slots:
          key_name: requestBody.keyName
          domain: path.domainName
      - text: Rotate key {key_name} for Event Grid domain {domain} in subscription {subscription}, resource group {resource_group}.
        slots:
          subscription: path.subscriptionId
          resource_group: path.resourceGroupName
          domain: path.domainName
          key_name: requestBody.keyName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DomainRegistration/domains/{domainName}/operationresults/{operationId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check the status of a domain purchase
      effect: read
      questions:
      - Has my domain purchase finished yet?
      - How can I track a pending domain registration operation?
      instructions:
      - text: Check purchase operation {operation} for domain {domain}.
        slots:
          operation: path.operationId
          domain: path.domainName
      - text: Get the status of operation {operation} on domain {domain} in subscription {subscription}, resource group {resource_group}.
        slots:
          subscription: path.subscriptionId
          resource_group: path.resourceGroupName
          domain: path.domainName
          operation: path.operationId
      method: generated
      generated: '2026-09-26'