swagger: '2.0'
info:
  version: 2020-08-01-preview
  title: Microsoft Azure AccessControlClient AccessConnector ServerCall API
schemes:
- https
tags:
- name: ServerCall
paths:
  /calling/serverCalls/{serverCallId}/participants:
    post:
      tags:
      - ServerCall
      summary: Microsoft Azure Add A Participant To The Call
      description: Add a participant to the call.
      operationId: microsoftAzureServercallsAddparticipant
      parameters:
      - name: serverCallId
        in: path
        description: The server call id.
        required: true
        type: string
      - name: addParticipantRequest
        in: body
        description: The add participant request.
        required: true
        schema:
          $ref: '#/definitions/AddParticipantRequest'
      - $ref: '#/parameters/ApiVersionParameter'
      responses:
        '202':
          description: Returns the add participant response.
          schema:
            $ref: '#/definitions/AddParticipantResult'
        '400':
          $ref: '#/responses/400'
        '401':
          $ref: '#/responses/401'
        '403':
          $ref: '#/responses/403'
        '404':
          $ref: '#/responses/404'
        '500':
          $ref: '#/responses/500'
      x-ms-examples:
        Add a participant to the call.:
          $ref: ./examples/ServerCalls_AddParticipant.json
  /calling/serverCalls/{serverCallId}/participants/{participantId}:
    delete:
      tags:
      - ServerCall
      summary: Microsoft Azure Remove Participant From The Call
      description: Remove participant from the call.
      operationId: microsoftAzureServercallsRemoveparticipant
      parameters:
      - name: serverCallId
        in: path
        description: Server call id.
        required: true
        type: string
      - name: participantId
        in: path
        description: Participant id.
        required: true
        type: string
      - $ref: '#/parameters/ApiVersionParameter'
      responses:
        '202':
          description: Returns the remove participant response.
        '400':
          $ref: '#/responses/400'
        '401':
          $ref: '#/responses/401'
        '403':
          $ref: '#/responses/403'
        '404':
          $ref: '#/responses/404'
        '500':
          $ref: '#/responses/500'
      x-ms-examples:
        Remove participant from the call.:
          $ref: ./examples/ServerCalls_RemoveParticipant.json
  /calling/serverCalls/{serverCallId}/:join:
    post:
      tags:
      - ServerCall
      summary: Microsoft Azure Join A Call
      description: Join a call.
      operationId: microsoftAzureServercallsJoincall
      parameters:
      - name: serverCallId
        in: path
        description: The server call id.
        required: true
        type: string
      - name: callRequest
        in: body
        description: The join call request.
        required: true
        schema:
          $ref: '#/definitions/JoinCallRequest'
      - $ref: '#/parameters/ApiVersionParameter'
      responses:
        '202':
          description: Returns the join call response.
          schema:
            $ref: '#/definitions/JoinCallResult'
        '400':
          $ref: '#/responses/400'
        '401':
          $ref: '#/responses/401'
        '403':
          $ref: '#/responses/403'
        '500':
          $ref: '#/responses/500'
      x-ms-examples:
        Join a call.:
          $ref: ./examples/ServerCalls_JoinCall.json
  /calling/serverCalls/{serverCallId}/:playAudio:
    post:
      tags:
      - ServerCall
      summary: Microsoft Azure Play Audio In The Call
      description: Play audio in the call.
      operationId: microsoftAzureServercallsPlayaudio
      parameters:
      - name: serverCallId
        in: path
        description: The server call id.
        required: true
        type: string
      - name: request
        in: body
        description: Play audio request.
        required: true
        schema:
          $ref: '#/definitions/PlayAudioRequest'
      - $ref: '#/parameters/ApiVersionParameter'
      responses:
        '202':
          description: Returns the play audio response.
          schema:
            $ref: '#/definitions/PlayAudioResult'
        '400':
          $ref: '#/responses/400'
        '401':
          $ref: '#/responses/401'
        '403':
          $ref: '#/responses/403'
        '404':
          $ref: '#/responses/404'
        '500':
          $ref: '#/responses/500'
      x-ms-examples:
        Play audio in the call.:
          $ref: ./examples/ServerCalls_PlayAudio.json
definitions:
  CommunicationErrorResponse:
    $ref: ../../../Common/stable/2021-03-07/common.json#/definitions/CommunicationErrorResponse
  PlayAudioResult:
    description: The response payload for play audio operation.
    required:
    - status
    type: object
    properties:
      operationId:
        description: The operation id.
        type: string
      status:
        $ref: '#/definitions/OperationStatus'
      operationContext:
        description: The operation context provided by client.
        type: string
      resultInfo:
        $ref: '#/definitions/ResultInfo'
        description: The result info for the operation.
  AddParticipantResult:
    description: The add participant result
    type: object
    properties:
      participantId:
        description: The id of the added participant.
        type: string
  OperationStatus:
    description: The status of the operation
    enum:
    - notStarted
    - running
    - completed
    - failed
    type: string
    x-ms-enum:
      name: OperationStatus
      modelAsString: true
  JoinCallResult:
    description: The response payload of the join call operation.
    type: object
    properties:
      callConnectionId:
        description: The call connection id.
        type: string
  JoinCallRequest:
    description: The request payload for join call.
    required:
    - source
    - callbackUri
    type: object
    properties:
      source:
        $ref: '#/definitions/CommunicationIdentifier'
        description: The source of the call.
      subject:
        description: The subject.
        type: string
      callbackUri:
        description: The callback URI.
        type: string
      requestedMediaTypes:
        description: The requested modalities.
        type: array
        items:
          $ref: '#/definitions/MediaType'
      requestedCallEvents:
        description: The requested call events to subscribe to.
        type: array
        items:
          $ref: '#/definitions/EventSubscriptionType'
  AddParticipantRequest:
    description: The add participant request.
    type: object
    properties:
      alternateCallerId:
        $ref: '#/definitions/PhoneNumberIdentifier'
        description: The alternate identity of source participant.
      participant:
        $ref: '#/definitions/CommunicationIdentifier'
        description: The participant to be added to the call.
      operationContext:
        description: The operation context.
        type: string
      callbackUri:
        description: The callback URI.
        type: string
  CommunicationIdentifier:
    $ref: ../../../Common/stable/2021-03-07/common.json#/definitions/CommunicationIdentifierModel
  MediaType:
    enum:
    - audio
    - video
    type: string
    x-ms-enum:
      name: MediaType
      modelAsString: true
  PlayAudioRequest:
    description: The request payload for playing audio.
    type: object
    properties:
      audioFileUri:
        description: "The media resource uri of the play audio request. \r\nCurrently only Wave file (.wav) format audio prompts are supported.\r\nMore specifically, the audio content in the wave file must be mono (single-channel),\r\n16-bit samples with a 16,000 (16KHz) sampling rate."
        type: string
      loop:
        description: The flag indicating whether audio file needs to be played in loop or not.
        type: boolean
      operationContext:
        description: The value to identify context of the operation.
        type: string
      audioFileId:
        description: An id for the media in the AudioFileUri, using which we cache the media resource.
        type: string
      callbackUri:
        description: The callback Uri to receive PlayAudio status notifications.
        type: string
  ResultInfo:
    description: Result info class to be used to report result status for actions/operations.
    required:
    - code
    - subcode
    type: object
    properties:
      code:
        format: int32
        description: The result code associated with the operation.
        type: integer
      subcode:
        format: int32
        description: The subcode that further classifies the result.
        type: integer
      message:
        description: The message is a detail explanation of subcode.
        type: string
  PhoneNumberIdentifier:
    $ref: ../../../Common/stable/2021-03-07/common.json#/definitions/PhoneNumberIdentifierModel
  EventSubscriptionType:
    enum:
    - participantsUpdated
    - dtmfReceived
    type: string
    x-ms-enum:
      name: EventSubscriptionType
      modelAsString: true
parameters:
  ApiVersionParameter:
    name: api-version
    in: query
    description: Version of API to invoke.
    required: true
    type: string
    x-ms-parameter-location: method
responses:
  '500':
    description: InternalServerError
    schema:
      $ref: '#/definitions/CommunicationErrorResponse'
    x-ms-error-response: true
  '404':
    description: NotFound
    schema:
      $ref: '#/definitions/CommunicationErrorResponse'
    x-ms-error-response: true
  '401':
    description: Unauthorized
    schema:
      $ref: '#/definitions/CommunicationErrorResponse'
    x-ms-error-response: true
  '400':
    description: BadRequest
    schema:
      $ref: '#/definitions/CommunicationErrorResponse'
    x-ms-error-response: true
  '403':
    description: Forbidden
    schema:
      $ref: '#/definitions/CommunicationErrorResponse'
    x-ms-error-response: true
x-ms-parameterized-host:
  hostTemplate: '{endpoint}'
  useSchemePrefix: false
  parameters:
  - $ref: '#/parameters/Endpoint'