# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Twilio SendGrid Email Senders API
  version: 1.0.0
extends: openapi/twilio-senders-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: 2
- target: $.paths['/verified_senders'].get
  update:
    x-apievangelist-phrasing:
      intent: List verified email senders
      effect: read
      questions:
      - Which from-addresses have I verified for sending email?
      - Can I see all my verified senders and their reply-to details?
      instructions:
      - text: List my verified email senders.
      - text: Show every sender identity I've verified for email.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/verified_senders'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a verified email sender
      effect: write
      questions:
      - How do I register a new from-address so I can send email from it?
      - What address details are required to create a verified sender?
      instructions:
      - text: Create verified sender {nickname} from {from_name} <{from_email}>, reply-to {reply_to_name} <{reply_to}>, at {address}, {city}, {country}.
        slots:
          nickname: requestBody.nickname
          from_name: requestBody.from_name
          from_email: requestBody.from_email
          reply_to_name: requestBody.reply_to_name
          reply_to: requestBody.reply_to
          address: requestBody.address
          city: requestBody.city
          country: requestBody.country
      - text: Add sender {from_email} named {from_name} (nickname {nickname}), replies to {reply_to} ({reply_to_name}), located {address}, {city}, {state} {zip}, {country}.
        slots:
          from_email: requestBody.from_email
          from_name: requestBody.from_name
          nickname: requestBody.nickname
          reply_to: requestBody.reply_to
          reply_to_name: requestBody.reply_to_name
          address: requestBody.address
          city: requestBody.city
          state: requestBody.state
          zip: requestBody.zip
          country: requestBody.country
      method: generated
      generated: '2026-09-26'