# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Novu Notifications API
  version: 1.0.0
extends: openapi/novu-notifications-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: 2
- target: $.paths['/v1/notifications'].get
  update:
    x-apievangelist-phrasing:
      intent: List triggered notification events
      effect: read
      questions:
      - How do I see the activity feed of workflows that were triggered?
      - Can I filter triggered events by subscriber, workflow or severity?
      - Which events were sent to a given topic?
      instructions:
      - text: List triggered events for subscribers {subscriberIds}.
        slots:
          subscriberIds: query.subscriberIds
      - text: Show events triggered with transaction id {transactionId}.
        slots:
          transactionId: query.transactionId
      - text: List events sent to topic {topicKey}.
        slots:
          topicKey: query.topicKey
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/notifications/{notificationId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a triggered event's details
      effect: read
      questions:
      - How can I see the execution logs and status of one triggered event?
      - What messages did each workflow step generate for a specific event?
      instructions:
      - text: Show me event {notificationId} with its execution logs.
        slots:
          notificationId: path.notificationId
      - text: Get the status and step messages for event {notificationId}.
        slots:
          notificationId: path.notificationId
      method: generated
      generated: '2026-09-26'