# 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 Programmable Connectivity Sim Swap API
  version: 1.0.0
extends: openapi/microsoft-azure-sim-swap-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['/sim-swap/sim-swap:retrieve'].post
  update:
    x-apievangelist-phrasing:
      intent: Get the latest SIM swap date for a phone number
      effect: read
      questions:
      - When was the SIM last swapped for a given phone number?
      - Can I get the timestamp of the most recent SIM swap from the network operator?
      instructions:
      - text: Get the latest SIM swap time for {phone} on network {network} via gateway {gateway}.
        slots:
          phone: requestBody.phoneNumber
          network: requestBody.networkIdentifier
          gateway: header.apc-gateway-id
      - text: Retrieve when the SIM for {phone} was last changed.
        slots:
          phone: requestBody.phoneNumber
      method: generated
      generated: '2026-09-26'
- target: $.paths['/sim-swap/sim-swap:verify'].post
  update:
    x-apievangelist-phrasing:
      intent: Verify whether a SIM swap happened recently
      effect: read
      questions:
      - Has the SIM for this phone number been swapped in the last few hours?
      - Can I check for a SIM swap within a specific number of hours before approving a transaction?
      instructions:
      - text: Verify whether {phone} on network {network} had a SIM swap in the last {hours} hours via gateway {gateway}.
        slots:
          phone: requestBody.phoneNumber
          network: requestBody.networkIdentifier
          hours: requestBody.maxAgeHours
          gateway: header.apc-gateway-id
      - text: Check if the SIM for {phone} was swapped within {hours} hours.
        slots:
          phone: requestBody.phoneNumber
          hours: requestBody.maxAgeHours
      method: generated
      generated: '2026-09-26'