# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for SMTP2GO STATISTICS API
  version: 1.0.0
extends: openapi/smtp2go-statistics-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: 6
- target: $.paths['/stats/email_bounces'].post
  update:
    x-apievangelist-phrasing:
      intent: Summarize bounces over the last 30 days
      effect: read
      questions:
      - How many of my emails bounced in the last 30 days?
      - Can I see the bounce and reject numbers for one SMTP user?
      instructions:
      - text: Show my email bounce summary.
      - text: Show bounces and rejects for {username}.
        slots:
          username: requestBody.username
      method: generated
      generated: '2026-10-01'
- target: $.paths['/stats/email_cycle'].post
  update:
    x-apievangelist-phrasing:
      intent: View usage for the current billing cycle
      effect: read
      questions:
      - How many emails have I sent so far this billing cycle?
      - When does my monthly plan cycle start and end?
      instructions:
      - text: Show my current billing cycle usage.
      - text: Tell me how many emails remain in this month's plan.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/stats/email_history'].post
  update:
    x-apievangelist-phrasing:
      intent: Report email activity by sender or domain
      effect: read
      questions:
      - Which sender addresses sent the most email last month?
      - Can I break down email activity by domain or subaccount for a date range?
      instructions:
      - text: Show email history grouped by {group_by} from {start_date} to {end_date}.
        slots:
          group_by: requestBody.group_by
          start_date: requestBody.start_date
          end_date: requestBody.end_date
      - text: Show email history for subaccounts {subaccounts}.
        slots:
          subaccounts: requestBody.subaccounts
      method: generated
      generated: '2026-10-01'
- target: $.paths['/stats/email_spam'].post
  update:
    x-apievangelist-phrasing:
      intent: Summarize spam complaints
      effect: read
      questions:
      - How many spam complaints did we get in the last 30 days?
      - Can I check spam complaints for a single SMTP user?
      instructions:
      - text: Show my spam complaint summary.
      - text: Show spam complaints and rejects for {username}.
        slots:
          username: requestBody.username
      method: generated
      generated: '2026-10-01'
- target: $.paths['/stats/email_summary'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a combined email statistics report
      effect: read
      questions:
      - Can I get bounces, spam, unsubscribes and cycle usage in one report?
      - What's the quickest way to see an overall SMTP2GO account email summary?
      instructions:
      - text: Give me the combined email summary report.
      - text: Show the full email summary for {username}.
        slots:
          username: requestBody.username
      method: generated
      generated: '2026-10-01'
- target: $.paths['/stats/email_unsubs'].post
  update:
    x-apievangelist-phrasing:
      intent: Summarize unsubscribes
      effect: read
      questions:
      - How many people unsubscribed in the last 30 days?
      - Can I see unsubscribe counts for one SMTP user?
      instructions:
      - text: Show my unsubscribe summary.
      - text: Show unsubscribes and rejects for {username}.
        slots:
          username: requestBody.username
      method: generated
      generated: '2026-10-01'