# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Cvent REST Emails API
  version: 1.0.0
extends: openapi/cvent-event-cloud-emails-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: 3
- target: $.paths['/bounces'].get
  update:
    x-apievangelist-phrasing:
      intent: List email bounces
      effect: read
      questions:
      - Which emails from my account bounced?
      - How far back can I look up email bounce data?
      instructions:
      - text: List email bounces since {after}.
        slots:
          after: query.after
      - text: Show bounced emails between {after} and {before}.
        slots:
          after: query.after
          before: query.before
      method: generated
      generated: '2026-09-26'
- target: $.paths['/emails'].get
  update:
    x-apievangelist-phrasing:
      intent: List sent email history
      effect: read
      questions:
      - What emails has my account sent recently?
      - Is there a limit on how many months of sent email history I can pull?
      instructions:
      - text: List emails sent after {after}.
        slots:
          after: query.after
      - text: Show the sent email history matching {filter}.
        slots:
          filter: query.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/emails/{emailRequestId}/status'].get
  update:
    x-apievangelist-phrasing:
      intent: Check the status of an email request
      effect: read
      questions:
      - What happened to the emails in a specific send request?
      - Can I track each email's status by the email request ID?
      instructions:
      - text: Get the email status for request {emailRequestId}.
        slots:
          emailRequestId: path.emailRequestId
      - text: Show per-recipient status of email request {emailRequestId}.
        slots:
          emailRequestId: path.emailRequestId
      method: generated
      generated: '2026-09-26'