# 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-callconnection-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 6
- target: $.paths['/calling/callConnections'].post
  update:
    x-apievangelist-phrasing:
      intent: Place an outbound call
      effect: write
      questions:
      - How do I place an outbound phone or VoIP call from my Communication Services app?
      - Can I set a subject or an alternate caller ID on an outbound call?
      - Where do call events get delivered when I start an outbound call?
      instructions:
      - text: Call {targets} from {source} and send call events to {callbackUri}.
        slots:
          targets: requestBody.targets
          source: requestBody.source
          callbackUri: requestBody.callbackUri
      - text: Start an outbound call to {targets} with subject {subject} and media types {requestedMediaTypes}.
        slots:
          targets: requestBody.targets
          subject: requestBody.subject
          requestedMediaTypes: requestBody.requestedMediaTypes
      method: generated
      generated: '2026-10-01'
- target: $.paths['/calling/callConnections/{callConnectionId}/:hangup'].post
  update:
    x-apievangelist-phrasing:
      intent: Hang up a call
      effect: destructive
      questions:
      - How do I end an active call connection?
      - Can I hang up a call from the server side?
      instructions:
      - text: Hang up call {call}.
        slots:
          call: path.callConnectionId
      - text: End the call connection {call}.
        slots:
          call: path.callConnectionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/calling/callConnections/{callConnectionId}/:playAudio'].post
  update:
    x-apievangelist-phrasing:
      intent: Play audio in a call
      effect: write
      questions:
      - Can I play an audio file to everyone on a call?
      - Is it possible to loop a prompt while callers wait?
      instructions:
      - text: Play audio {audio} in call {call}.
        slots:
          audio: requestBody.audioFileUri
          call: path.callConnectionId
      - text: Loop the audio file {audio} on call {call}.
        slots:
          audio: requestBody.audioFileUri
          call: path.callConnectionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/calling/callConnections/{callConnectionId}/:cancelAllMediaOperations'].post
  update:
    x-apievangelist-phrasing:
      intent: Cancel all media operations on a call
      effect: destructive
      questions:
      - How do I stop audio that is currently playing on a call?
      - Can I cancel every pending media operation for a call at once?
      instructions:
      - text: Cancel all media operations on call {call}.
        slots:
          call: path.callConnectionId
      - text: Stop every playing or queued media action in call {call}.
        slots:
          call: path.callConnectionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/calling/callConnections/{callConnectionId}/participants'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a participant to a call
      effect: write
      questions:
      - Can I bring another person into an ongoing call?
      - What caller ID is shown when I add a participant to a call?
      instructions:
      - text: Add participant {participant} to call {call}.
        slots:
          participant: requestBody.participant
          call: path.callConnectionId
      - text: Invite {participant} into call {call} using caller ID {callerId}.
        slots:
          participant: requestBody.participant
          call: path.callConnectionId
          callerId: requestBody.alternateCallerId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/calling/callConnections/{callConnectionId}/participants/{participantId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a participant from a call
      effect: destructive
      questions:
      - Can I drop one participant from a call without ending it?
      - What do I need to remove someone from a call connection?
      instructions:
      - text: Remove participant {participant} from call {call}.
        slots:
          participant: path.participantId
          call: path.callConnectionId
      - text: Kick {participant} off call {call}.
        slots:
          participant: path.participantId
          call: path.callConnectionId
      method: generated
      generated: '2026-09-26'