# 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 Batch Numbers API
  version: 1.0.0
extends: openapi/microsoft-azure-batchnumbers-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: 3
- target: $.paths['/account/{accountName}/numbers:batch'].post
  update:
    x-apievangelist-phrasing:
      intent: Add or replace phone numbers atomically
      effect: write
      questions:
      - How do I add up to 100 phone numbers to an account in one batch?
      - If one number in the batch fails, do the others still go through?
      instructions:
      - text: Add or replace numbers {numbers} on account {account} as one atomic batch.
        slots:
          numbers: requestBody.numbers
          account: path.accountName
      - text: Batch-replace phone numbers {numbers} and their enabled services on {account}.
        slots:
          numbers: requestBody.numbers
          account: path.accountName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/accounts/{accountName}:createOrUpdateNumbers'].post
  update:
    x-apievangelist-phrasing:
      intent: Create or update numbers on an account
      effect: write
      questions:
      - Can I safely retry a create-or-update numbers request without duplicates?
      - How many numbers can I create or update per request on an accounts resource?
      instructions:
      - text: Create or update numbers {numbers} on account {account}.
        slots:
          numbers: requestBody.numbers
          account: path.accountName
      - text: Upsert numbers {numbers} on {account} with repeatability ID {rid}.
        slots:
          numbers: requestBody.numbers
          account: path.accountName
          rid: header.Repeatability-Request-ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/accounts/{accountName}:deleteNumbers'].post
  update:
    x-apievangelist-phrasing:
      intent: Delete numbers from an account
      effect: destructive
      questions:
      - How do I remove phone numbers from an account in bulk?
      - What is the most numbers I can delete in one call?
      instructions:
      - text: Delete numbers {numbers} from account {account}.
        slots:
          numbers: requestBody.numbers
          account: path.accountName
      - text: Remove up to 100 numbers {numbers} from {account} with repeatability ID {rid}.
        slots:
          numbers: requestBody.numbers
          account: path.accountName
          rid: header.Repeatability-Request-ID
      method: generated
      generated: '2026-09-26'