# 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-notificationrecipientuser-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}/recipientUsers'].get
  update:
    x-apievangelist-phrasing:
      intent: List users subscribed to an API Management notification
      effect: read
      questions:
      - Which API Management users receive a given workspace notification?
      - How do I see the recipient users of a notification in an APIM workspace?
      instructions:
      - text: List the recipient users of notification {notification} in workspace {workspace} on APIM service {service}.
        slots:
          notification: path.notificationName
          workspace: path.workspaceId
          service: path.serviceName
      - text: Show who is subscribed to this APIM notification.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/workspaces/{workspaceId}/notifications/{notificationName}/recipientUsers/{userId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Add a user as a notification recipient
      effect: write
      questions:
      - How do I subscribe an API Management user to a workspace notification?
      - Can a developer portal user receive APIM notification emails?
      instructions:
      - text: Add API Management user {user} to the recipients of notification {notification} in workspace {workspace}, service {service}.
        slots:
          user: path.userId
          notification: path.notificationName
          workspace: path.workspaceId
          service: path.serviceName
      - text: Subscribe the APIM user to this workspace notification.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/workspaces/{workspaceId}/notifications/{notificationName}/recipientUsers/{userId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a user from notification recipients
      effect: destructive
      questions:
      - How do I stop an API Management user from receiving a notification?
      - Can I unsubscribe one user from an APIM workspace notification?
      instructions:
      - text: Take user {user} off notification {notification} recipients in workspace {workspace} of service {service}.
        slots:
          user: path.userId
          notification: path.notificationName
          workspace: path.workspaceId
          service: path.serviceName
      - text: Unsubscribe the APIM user from this workspace notification.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/workspaces/{workspaceId}/notifications/{notificationName}/recipientUsers/{userId}'].head
  update:
    x-apievangelist-phrasing:
      intent: Check if a user is subscribed to a notification
      effect: read
      questions:
      - Is a particular API Management user already a recipient of this notification?
      - How can I verify a user's notification subscription without listing everyone?
      instructions:
      - text: Check whether user {user} is subscribed to notification {notification} in workspace {workspace}, service {service}.
        slots:
          user: path.userId
          notification: path.notificationName
          workspace: path.workspaceId
          service: path.serviceName
      - text: Confirm the APIM user is subscribed to this workspace notification.
      method: generated
      generated: '2026-10-01'