# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Microsoft Azure PhoneNumbersClient Manage Purchased Phone…
  version: 1.0.0
extends: openapi/microsoft-azure-manage-purchased-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: 4
- target: $.paths['/phoneNumbers/{phoneNumber}/capabilities'].patch
  update:
    x-apievangelist-phrasing:
      intent: Change calling and SMS capabilities of a number
      effect: write
      questions:
      - How do I enable SMS on a phone number I already purchased in Communication Services?
      - Can I switch a purchased number's calling capability to inbound only?
      instructions:
      - text: Set SMS capability on {phoneNumber} to {sms}.
        slots:
          phoneNumber: path.phoneNumber
          sms: requestBody.sms
      - text: Update calling capability of {phoneNumber} to {calling}.
        slots:
          phoneNumber: path.phoneNumber
          calling: requestBody.calling
      method: generated
      generated: '2026-09-26'
- target: $.paths['/phoneNumbers/{phoneNumber}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get details of a purchased phone number
      effect: read
      questions:
      - What capabilities and cost does one of my purchased phone numbers have?
      - How do I look up a specific number I own?
      instructions:
      - text: Show details of purchased number {phoneNumber}.
        slots:
          phoneNumber: path.phoneNumber
      - text: Get the capabilities of my phone number {phoneNumber}.
        slots:
          phoneNumber: path.phoneNumber
      method: generated
      generated: '2026-09-26'
- target: $.paths['/phoneNumbers/{phoneNumber}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Release a purchased phone number
      effect: destructive
      questions:
      - How do I give back a phone number I no longer need?
      - Can I release a purchased number so I stop paying for it?
      instructions:
      - text: Release phone number {phoneNumber}.
        slots:
          phoneNumber: path.phoneNumber
      - text: Give up ownership of {phoneNumber}.
        slots:
          phoneNumber: path.phoneNumber
      method: generated
      generated: '2026-09-26'
- target: $.paths['/phoneNumbers'].get
  update:
    x-apievangelist-phrasing:
      intent: List purchased phone numbers
      effect: read
      questions:
      - Which phone numbers have I purchased in my Communication Services resource?
      - Can I page through my purchased numbers with skip and top?
      instructions:
      - text: List all my purchased phone numbers.
      - text: List {top} purchased numbers skipping the first {skip}.
        slots:
          top: query.top
          skip: query.skip
      method: generated
      generated: '2026-09-26'