# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Amazon Neptune Management Events API
  version: 1.0.0
extends: openapi/amazon-neptune-events-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: 2
- target: $.paths['/?Action=CreateEventSubscription'].post
  update:
    x-apievangelist-phrasing:
      intent: Subscribe to Neptune event notifications
      effect: write
      questions:
      - How do I get notified through SNS when something happens to my Neptune cluster?
      - Can I limit an event subscription to a single source type like instances?
      instructions:
      - text: Create event subscription {name} sending to SNS topic {topic}.
        slots:
          name: query.SubscriptionName
          topic: query.SnsTopicArn
      - text: Subscribe {topic} to Neptune {source_type} events under the name {name}.
        slots:
          name: query.SubscriptionName
          topic: query.SnsTopicArn
          source_type: query.SourceType
      method: generated
      generated: '2026-10-01'
- target: $.paths['/?Action=DescribeEvents'].get
  update:
    x-apievangelist-phrasing:
      intent: Review recent Neptune events
      effect: read
      questions:
      - What happened to my Neptune cluster over the last few days?
      - How far back can I see Neptune events for instances and snapshots?
      - Can I filter Neptune events to one source?
      instructions:
      - text: Show recent Neptune events.
      - text: Show events for {source} from the last {minutes} minutes.
        slots:
          source: query.SourceIdentifier
          minutes: query.Duration
      method: generated
      generated: '2026-10-01'