# 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 Event Channels API
  version: 1.0.0
extends: openapi/microsoft-azure-eventchannels-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/partnerNamespaces/{partnerNamespaceName}/eventChannels/{eventChannelName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an Event Grid event channel
      effect: read
      questions:
      - How do I look up the properties of one event channel in a partner namespace?
      - What state is a specific Event Grid event channel in?
      instructions:
      - text: Get event channel {channel} in partner namespace {namespace}, {resource_group}, subscription {subscription}.
        slots:
          channel: path.eventChannelName
          namespace: path.partnerNamespaceName
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Show the properties of event channel {channel}.
        slots:
          channel: path.eventChannelName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/partnerNamespaces/{partnerNamespaceName}/eventChannels/{eventChannelName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create an Event Grid event channel
      effect: write
      questions:
      - How do I create an event channel for a partner namespace?
      - Can I set the source and destination of a new event channel?
      instructions:
      - text: Create event channel {channel} in partner namespace {namespace}, {resource_group}, subscription {subscription}.
        slots:
          channel: path.eventChannelName
          namespace: path.partnerNamespaceName
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Set up event channel {channel} with {properties}.
        slots:
          channel: path.eventChannelName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/partnerNamespaces/{partnerNamespaceName}/eventChannels/{eventChannelName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an Event Grid event channel
      effect: destructive
      questions:
      - How do I remove an event channel from my partner namespace?
      - Can I delete an existing Event Grid event channel?
      instructions:
      - text: Delete event channel {channel} from partner namespace {namespace}, {resource_group}, subscription {subscription}.
        slots:
          channel: path.eventChannelName
          namespace: path.partnerNamespaceName
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Remove event channel {channel}.
        slots:
          channel: path.eventChannelName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/partnerNamespaces/{partnerNamespaceName}/eventChannels'].get
  update:
    x-apievangelist-phrasing:
      intent: List event channels in a partner namespace
      effect: read
      questions:
      - Which event channels exist in one Event Grid partner namespace?
      - Can I filter or cap the number of event channels returned?
      instructions:
      - text: List event channels in partner namespace {namespace}, {resource_group}, subscription {subscription}.
        slots:
          namespace: path.partnerNamespaceName
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Show the first {top} event channels in {namespace} matching {filter}.
        slots:
          top: query.$top
          namespace: path.partnerNamespaceName
          filter: query.$filter
      method: generated
      generated: '2026-09-26'