API Evangelist conversational phrasing for Paubox Email Messages API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Paubox Email Messages API
  version: 1.0.0
extends: openapi/paubox-messages-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: 3
- target: $.paths['/messages'].post
  update:
    x-apievangelist-phrasing:
      intent: Send a single secure email
      effect: write
      questions:
      - How do I send one HIPAA-compliant email through Paubox?
      - Can I send a single transactional email via the API?
      instructions:
      - text: 'Send this email: {data}.'
        slots:
          data: requestBody.data
      - text: Send one secure message with the content in {data}.
        slots:
          data: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/bulk_messages'].post
  update:
    x-apievangelist-phrasing:
      intent: Send a batch of emails in one request
      effect: write
      questions:
      - Can I send many emails in a single request?
      - How many messages should I put in one batch send?
      instructions:
      - text: 'Send this batch of messages: {data}.'
        slots:
          data: requestBody.data
      - text: Send the messages in {data} together as one bulk request.
        slots:
          data: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/message_receipt'].get
  update:
    x-apievangelist-phrasing:
      intent: Check delivery and open status of a sent email
      effect: read
      questions:
      - Was my email delivered, and did the recipient open it?
      - How do I check click tracking for a message I already sent?
      instructions:
      - text: Get the delivery receipt for message {sourceTrackingId}.
        slots:
          sourceTrackingId: query.sourceTrackingId
      - text: Check whether email {sourceTrackingId} was delivered and opened.
        slots:
          sourceTrackingId: query.sourceTrackingId
      method: generated
      generated: '2026-10-01'