# 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 ApiManagementClient Notification Recipient…
  version: 1.0.0
extends: openapi/microsoft-azure-notificationrecipientemail-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 4
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/workspaces/{workspaceId}/notifications/{notificationName}/recipientEmails'].get
  update:
    x-apievangelist-phrasing:
      intent: List recipient emails for a workspace notification
      effect: read
      questions:
      - Which email addresses receive a given API Management workspace notification?
      - Who is subscribed to a notification in my APIM workspace?
      instructions:
      - text: List the recipient emails subscribed to notification {notification} in workspace {workspace} of service {service}.
        slots:
          notification: path.notificationName
          workspace: path.workspaceId
          service: path.serviceName
      - text: Show who gets emailed for the API Management workspace notification.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/workspaces/{workspaceId}/notifications/{notificationName}/recipientEmails/{email}'].put
  update:
    x-apievangelist-phrasing:
      intent: Add a recipient email to a workspace notification
      effect: write
      questions:
      - How do I add an email address to an API Management workspace notification?
      - Can I subscribe an outside email address to APIM notifications in a workspace?
      instructions:
      - text: Add {email} as a recipient of notification {notification} in APIM workspace {workspace}, service {service}.
        slots:
          email: path.email
          notification: path.notificationName
          workspace: path.workspaceId
          service: path.serviceName
      - text: Subscribe the email to the API Management workspace notification.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/workspaces/{workspaceId}/notifications/{notificationName}/recipientEmails/{email}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a recipient email from a workspace notification
      effect: destructive
      questions:
      - Can I stop an email address from receiving an APIM workspace notification?
      - What removes a recipient email from a notification?
      instructions:
      - text: Remove {email} from the recipients of notification {notification} in workspace {workspace} on service {service}.
        slots:
          email: path.email
          notification: path.notificationName
          workspace: path.workspaceId
          service: path.serviceName
      - text: Unsubscribe the email from the API Management workspace notification.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/workspaces/{workspaceId}/notifications/{notificationName}/recipientEmails/{email}'].head
  update:
    x-apievangelist-phrasing:
      intent: Check if an email is subscribed to a notification
      effect: read
      questions:
      - Is a particular email address already a recipient of a workspace notification?
      - Can I verify an email is subscribed to an APIM notification without listing all recipients?
      instructions:
      - text: Check whether {email} already receives notification {notification} in workspace {workspace}, service {service}.
        slots:
          email: path.email
          notification: path.notificationName
          workspace: path.workspaceId
          service: path.serviceName
      - text: Confirm the address is a recipient of the API Management workspace notification.
      method: generated
      generated: '2026-10-01'