# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Snov.io Email Accounts API
  version: 1.0.0
extends: openapi/snov-io-email-accounts-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: 4
- target: $.paths['/v2/sender-accounts/emails'].get
  update:
    x-apievangelist-phrasing:
      intent: List connected sender email accounts
      effect: read
      questions:
      - Which sender mailboxes have I connected?
      - Can I see the status of all my connected sending accounts?
      instructions:
      - text: List my connected sender email accounts.
      - text: Show every sending mailbox and its status.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/sender-accounts/emails'].post
  update:
    x-apievangelist-phrasing:
      intent: Connect a sender email account
      effect: write
      questions:
      - How do I connect a new mailbox for sending campaigns using SMTP?
      - Can I set a delay between sends when adding a sender account?
      instructions:
      - text: Connect sender {email_from} named {sender_name} with password {password} via SMTP {smtp}.
        slots:
          email_from: requestBody.email_from
          sender_name: requestBody.sender_name
          password: requestBody.password
          smtp: requestBody.smtp
      - text: Add mailbox {email_from} as {sender_name}, password {password}, SMTP {smtp} and IMAP {imap}.
        slots:
          email_from: requestBody.email_from
          sender_name: requestBody.sender_name
          password: requestBody.password
          smtp: requestBody.smtp
          imap: requestBody.imap
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/sender-accounts/emails/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a sender email account
      effect: write
      questions:
      - Can I change the signature on a sender account I already connected?
      - Is it possible to update SMTP settings for an existing mailbox?
      instructions:
      - text: Update the signature on sender account {id} to {signature}.
        slots:
          id: path.id
          signature: requestBody.signature
      - text: Change the SMTP settings of sender account {id} to {smtp}.
        slots:
          id: path.id
          smtp: requestBody.smtp
      - text: Set the send delay for sender account {id} to {delay} seconds.
        slots:
          id: path.id
          delay: requestBody.delay
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/sender-accounts/check-sender-status'].get
  update:
    x-apievangelist-phrasing:
      intent: Check a sender account's connection status
      effect: read
      questions:
      - Why is my sender mailbox not sending — is its SMTP or IMAP connection broken?
      - Can I check whether a sender account's connection is valid or still pending?
      instructions:
      - text: Check connection status for sender account {sender_account_id}.
        slots:
          sender_account_id: query.sender_account_id
      - text: Verify SMTP and IMAP for sender {sender_account_id}.
        slots:
          sender_account_id: query.sender_account_id
      method: generated
      generated: '2026-10-01'