# 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 Neptune Streams Property Graph Stream API
  version: 1.0.0
extends: openapi/amazon-neptune-property-graph-stream-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['/propertygraph/stream'].get
  update:
    x-apievangelist-phrasing:
      intent: Read property graph change records
      effect: read
      questions:
      - How do I capture changes made to my Gremlin or openCypher data?
      - Can I resume reading the property graph change log from a specific commit number?
      - Can I get the property graph stream compressed?
      instructions:
      - text: Read the property graph change stream starting at commit {commit}.
        slots:
          commit: query.commitNum
      - text: Fetch {limit} property graph change records, iterator type {iterator}.
        slots:
          limit: query.limit
          iterator: query.iteratorType
      - text: Get property graph changes with Accept-Encoding {encoding}.
        slots:
          encoding: header.Accept-Encoding
      method: generated
      generated: '2026-10-01'
- target: $.paths['/pg/stream'].get
  update:
    x-apievangelist-phrasing:
      intent: Read property graph changes via short path
      effect: read
      questions:
      - Is there a shorter /pg/stream path for the property graph change log?
      - Can I use the pg alias endpoint to read change records after a commit?
      instructions:
      - text: Read the /pg/stream alias from commit {commit}, operation {op}.
        slots:
          commit: query.commitNum
          op: query.opNum
      - text: Fetch {limit} records from the short pg change stream alias.
        slots:
          limit: query.limit
      method: generated
      generated: '2026-10-01'