# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Twilio - Routes Phone Numbers API
  version: 1.0.0
extends: openapi/twilio-phone-numbers-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['/v2/PhoneNumbers/{PhoneNumber}'].get
  update:
    x-apievangelist-phrasing:
      intent: See a number's inbound processing region
      effect: read
      questions:
      - In which region are inbound calls to my phone number processed?
      - Can I check the voice region assigned to one of my numbers?
      instructions:
      - text: Show the inbound processing region for {phone_number}.
        slots:
          phone_number: path.PhoneNumber
      - text: Get the voice region currently assigned to number {phone_number}.
        slots:
          phone_number: path.PhoneNumber
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/PhoneNumbers/{PhoneNumber}'].post
  update:
    x-apievangelist-phrasing:
      intent: Assign an inbound processing region to a number
      effect: write
      questions:
      - How do I have inbound calls to a number processed in a different region?
      - Can I pin a phone number's inbound voice traffic to one region?
      instructions:
      - text: Assign inbound processing region {voice_region} to {phone_number}.
        slots:
          voice_region: requestBody.VoiceRegion
          phone_number: path.PhoneNumber
      - text: Move inbound voice processing for number {phone_number} to {voice_region}.
        slots:
          phone_number: path.PhoneNumber
          voice_region: requestBody.VoiceRegion
      method: generated
      generated: '2026-09-26'