# 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 Azure Communication CallingServer Service…
  version: 1.0.0
extends: openapi/microsoft-azure-servercall-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['/calling/serverCalls/{serverCallId}/participants'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a participant to a server call
      effect: write
      questions:
      - How do I invite someone into an ongoing server call?
      - Can I set an alternate caller ID when adding a participant?
      instructions:
      - text: Add participant {participant} to server call {call}.
        slots:
          participant: requestBody.participant
          call: path.serverCallId
      - text: Bring {participant} into call {call} showing caller ID {caller_id}.
        slots:
          participant: requestBody.participant
          call: path.serverCallId
          caller_id: requestBody.alternateCallerId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/calling/serverCalls/{serverCallId}/participants/{participantId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a participant from a server call
      effect: destructive
      questions:
      - How do I drop a participant from a call?
      - Can I kick one person out of a server call?
      instructions:
      - text: Remove participant {participant} from server call {call}.
        slots:
          participant: path.participantId
          call: path.serverCallId
      - text: Hang up on participant {participant} in call {call}.
        slots:
          participant: path.participantId
          call: path.serverCallId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/calling/serverCalls/{serverCallId}/:join'].post
  update:
    x-apievangelist-phrasing:
      intent: Join a server call
      effect: write
      questions:
      - How does my app join an existing server call?
      - What callback URI and media types do I set when joining a call?
      instructions:
      - text: Join server call {call} as {source} with callback {callback}.
        slots:
          call: path.serverCallId
          source: requestBody.source
          callback: requestBody.callbackUri
      - text: Join call {call} requesting media types {media_types}.
        slots:
          call: path.serverCallId
          media_types: requestBody.requestedMediaTypes
      method: generated
      generated: '2026-09-26'
- target: $.paths['/calling/serverCalls/{serverCallId}/:playAudio'].post
  update:
    x-apievangelist-phrasing:
      intent: Play audio into a server call
      effect: write
      questions:
      - How do I play an audio prompt to everyone on a call?
      - Can the audio loop until stopped?
      instructions:
      - text: Play audio {audio_url} in server call {call}.
        slots:
          audio_url: requestBody.audioFileUri
          call: path.serverCallId
      - text: Loop audio file {audio_url} in call {call}.
        slots:
          audio_url: requestBody.audioFileUri
          call: path.serverCallId
      method: generated
      generated: '2026-09-26'