# 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 ProviderHub Notification Registration API
  version: 1.0.0
extends: openapi/microsoft-azure-notificationregistration-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}/providers/Microsoft.ProviderHub/providerRegistrations/{providerNamespace}/notificationRegistrations/{notificationRegistrationName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a provider notification registration
      effect: read
      questions:
      - What endpoints and events does a ProviderHub notification registration use?
      - Can I look up one notification registration for my resource provider?
      instructions:
      - text: Get notification registration {registration} for provider namespace {providerNamespace}.
        slots:
          registration: path.notificationRegistrationName
          providerNamespace: path.providerNamespace
      - text: Show the details of {providerNamespace} notification registration {registration}.
        slots:
          providerNamespace: path.providerNamespace
          registration: path.notificationRegistrationName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.ProviderHub/providerRegistrations/{providerNamespace}/notificationRegistrations/{notificationRegistrationName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a provider notification registration
      effect: write
      questions:
      - How do I register my resource provider to receive ProviderHub notifications?
      - Can I change the notification endpoints on an existing registration?
      instructions:
      - text: Create notification registration {registration} for provider namespace {providerNamespace}.
        slots:
          registration: path.notificationRegistrationName
          providerNamespace: path.providerNamespace
      - text: Update {providerNamespace} notification registration {registration} with properties {properties}.
        slots:
          providerNamespace: path.providerNamespace
          registration: path.notificationRegistrationName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.ProviderHub/providerRegistrations/{providerNamespace}/notificationRegistrations/{notificationRegistrationName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a provider notification registration
      effect: destructive
      questions:
      - How do I stop my resource provider receiving a set of ProviderHub notifications?
      - Can I delete a single notification registration from a provider?
      instructions:
      - text: Delete notification registration {registration} from provider namespace {providerNamespace}.
        slots:
          registration: path.notificationRegistrationName
          providerNamespace: path.providerNamespace
      - text: Remove the {registration} notification registration on {providerNamespace}.
        slots:
          registration: path.notificationRegistrationName
          providerNamespace: path.providerNamespace
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.ProviderHub/providerRegistrations/{providerNamespace}/notificationRegistrations'].get
  update:
    x-apievangelist-phrasing:
      intent: List notification registrations for a provider
      effect: read
      questions:
      - Which notification registrations exist for my ProviderHub resource provider?
      - Can I see every notification registration under one provider namespace?
      instructions:
      - text: List notification registrations for provider namespace {providerNamespace}.
        slots:
          providerNamespace: path.providerNamespace
      - text: Show all notification registrations configured on {providerNamespace}.
        slots:
          providerNamespace: path.providerNamespace
      method: generated
      generated: '2026-09-26'