# 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 EventGridManagementClient Domain Topics API
  version: 1.0.0
extends: openapi/microsoft-azure-domaintopics-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['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/domains/{domainName}/topics/{domainTopicName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an Event Grid domain topic
      effect: read
      questions:
      - What are the properties of one topic inside my Event Grid domain?
      - Can I check the provisioning state of a domain topic by name?
      instructions:
      - text: Get domain topic {topic} in Event Grid domain {domain}, group {group}, subscription {subscription}.
        slots:
          topic: path.domainTopicName
          domain: path.domainName
          group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Show the properties of topic {topic} in domain {domain}.
        slots:
          topic: path.domainTopicName
          domain: path.domainName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/domains/{domainName}/topics/{domainTopicName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a topic in an Event Grid domain
      effect: write
      questions:
      - How do I add a new topic to an Event Grid domain for one of my tenants?
      - Is creating a domain topic asynchronous?
      instructions:
      - text: Create domain topic {topic} in Event Grid domain {domain}, group {group}, subscription {subscription}.
        slots:
          topic: path.domainTopicName
          domain: path.domainName
          group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Add topic {topic} to domain {domain}.
        slots:
          topic: path.domainTopicName
          domain: path.domainName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/domains/{domainName}/topics/{domainTopicName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an Event Grid domain topic
      effect: destructive
      questions:
      - Can I remove a topic from my Event Grid domain once a tenant leaves?
      - What deletes an existing domain topic?
      instructions:
      - text: Delete domain topic {topic} from Event Grid domain {domain}, group {group}, subscription {subscription}.
        slots:
          topic: path.domainTopicName
          domain: path.domainName
          group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Remove topic {topic} from domain {domain}.
        slots:
          topic: path.domainTopicName
          domain: path.domainName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/domains/{domainName}/topics'].get
  update:
    x-apievangelist-phrasing:
      intent: List topics in an Event Grid domain
      effect: read
      questions:
      - Which topics exist in my Event Grid domain?
      - Can I filter domain topics by name and cap how many come back?
      instructions:
      - text: List all topics in Event Grid domain {domain}, group {group}, subscription {subscription}.
        slots:
          domain: path.domainName
          group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Show the first {top} topics in domain {domain} matching {filter}.
        slots:
          top: query.$top
          domain: path.domainName
          filter: query.$filter
      method: generated
      generated: '2026-09-26'