# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Mailchimp Transactional Rejects API
  version: 1.0.0
extends: openapi/mailchimp-rejects-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: 6
- target: $.paths['/rejects/add'].post
  update:
    x-apievangelist-phrasing:
      intent: Block an email address from receiving mail
      effect: write
      questions:
      - How do I stop transactional email from going to a specific address?
      - Do manually denylisted email addresses ever expire?
      instructions:
      - text: Add {email} to the email denylist.
        slots:
          email: requestBody.email
      - text: Block {email} for subaccount {subaccount} with the note {comment}.
        slots:
          email: requestBody.email
          subaccount: requestBody.subaccount
          comment: requestBody.comment
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rejects/list'].post
  update:
    x-apievangelist-phrasing:
      intent: List denylisted email addresses
      effect: read
      questions:
      - Which email addresses are on my rejection denylist?
      - Is a particular email address currently blocked?
      - Can I include expired email rejections in the list?
      instructions:
      - text: List my denylisted email addresses.
      - text: Check whether {email} is on the email denylist.
        slots:
          email: requestBody.email
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rejects/delete'].post
  update:
    x-apievangelist-phrasing:
      intent: Remove an email address from the denylist
      effect: write
      questions:
      - How do I unblock an email address so it can receive mail again?
      - Does removing an address from the denylist hurt my reputation?
      instructions:
      - text: Remove {email} from the email denylist.
        slots:
          email: requestBody.email
      - text: Unblock {email} for subaccount {subaccount}.
        slots:
          email: requestBody.email
          subaccount: requestBody.subaccount
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rejects/add-sms'].post
  update:
    x-apievangelist-phrasing:
      intent: Block a phone number from receiving SMS
      effect: write
      questions:
      - How do I stop text messages from going to a certain phone number?
      - What format does a phone number need to be in to block it from SMS?
      instructions:
      - text: Add phone number {phone} to the SMS denylist.
        slots:
          phone: requestBody.phone
      - text: Block SMS to {phone} with the note {comment}.
        slots:
          phone: requestBody.phone
          comment: requestBody.comment
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rejects/list-sms'].post
  update:
    x-apievangelist-phrasing:
      intent: List denylisted phone numbers
      effect: read
      questions:
      - Which phone numbers are blocked from receiving my SMS?
      - Is a specific number on the SMS denylist?
      instructions:
      - text: List my SMS denylist.
      - text: Check whether {phone} is blocked from SMS.
        slots:
          phone: requestBody.phone
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rejects/delete-sms'].post
  update:
    x-apievangelist-phrasing:
      intent: Remove a phone number from the SMS denylist
      effect: write
      questions:
      - How do I unblock a phone number so it can get texts again?
      - Can I remove an SMS rejection for just one subaccount?
      instructions:
      - text: Remove {phone} from the SMS denylist.
        slots:
          phone: requestBody.phone
      - text: Unblock SMS to {phone} for subaccount {subaccount}.
        slots:
          phone: requestBody.phone
          subaccount: requestBody.subaccount
      method: generated
      generated: '2026-09-26'