Microsoft Azure Azure Communication CallingServer Service — CallConnection

naftiko: 1.0.0-alpha2
info:
  label: Microsoft Azure Azure Communication CallingServer Service — CallConnection
  description: 'Microsoft Azure Azure Communication CallingServer Service — CallConnection. 6 operations. Lead operation:
    Microsoft Azure Create A New Call. Self-contained Naftiko capability covering one Microsoft Azure business surface.'
  tags:
  - Microsoft Azure
  - CallConnection
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    MICROSOFT_AZURE_API_KEY: MICROSOFT_AZURE_API_KEY
capability:
  consumes:
  - type: http
    namespace: azure-communication-callingserver-service-callconnection
    baseUri: ''
    description: Microsoft Azure Azure Communication CallingServer Service — CallConnection business capability. Self-contained,
      no shared references.
    resources:
    - name: calling-callConnections
      path: /calling/callConnections
      operations:
      - name: microsoftazurecallconnectionscreatecall
        method: POST
        description: Microsoft Azure Create A New Call
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: callRequest
          in: body
          type: string
          description: Create call request.
          required: true
    - name: calling-callConnections-callConnectionId-:cancelAllMediaOperations
      path: /calling/callConnections/{callConnectionId}/:cancelAllMediaOperations
      operations:
      - name: microsoftazurecallconnectionscancelallmediaoperations
        method: POST
        description: Microsoft Azure Cancel All Media Operations
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: callConnectionId
          in: path
          type: string
          description: The call connection id
          required: true
        - name: cancelAllMediaOperationRequest
          in: body
          type: string
          description: The cancel all media operations context.
          required: true
    - name: calling-callConnections-callConnectionId-:hangup
      path: /calling/callConnections/{callConnectionId}/:hangup
      operations:
      - name: microsoftazurecallconnectionshangupcall
        method: POST
        description: Microsoft Azure Hangup The Call
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: callConnectionId
          in: path
          type: string
          description: The call connection id.
          required: true
    - name: calling-callConnections-callConnectionId-:playAudio
      path: /calling/callConnections/{callConnectionId}/:playAudio
      operations:
      - name: microsoftazurecallconnectionsplayaudio
        method: POST
        description: Microsoft Azure Play Audio In The Call
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: callConnectionId
          in: path
          type: string
          description: The call connection id.
          required: true
        - name: request
          in: body
          type: string
          description: Play audio request.
          required: true
    - name: calling-callConnections-callConnectionId-participants
      path: /calling/callConnections/{callConnectionId}/participants
      operations:
      - name: microsoftazurecallconnectionsaddparticipant
        method: POST
        description: Microsoft Azure Add A Participant To The Call
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: callConnectionId
          in: path
          type: string
          description: The call connection id.
          required: true
        - name: addParticipantRequest
          in: body
          type: string
          description: Add participant request.
          required: true
    - name: calling-callConnections-callConnectionId-participants-participantId
      path: /calling/callConnections/{callConnectionId}/participants/{participantId}
      operations:
      - name: microsoftazurecallconnectionsremoveparticipant
        method: DELETE
        description: Microsoft Azure Remove A Participant From The Call
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: callConnectionId
          in: path
          type: string
          description: The call connection id.
          required: true
        - name: participantId
          in: path
          type: string
          description: The participant id.
          required: true
  exposes:
  - type: rest
    namespace: azure-communication-callingserver-service-callconnection-rest
    port: 8080
    description: REST adapter for Microsoft Azure Azure Communication CallingServer Service — CallConnection. One Spectral-compliant
      resource per consumed operation, prefixed with /v1.
    resources:
    - path: /v1/calling/callconnections
      name: calling-callconnections
      description: REST surface for calling-callConnections.
      operations:
      - method: POST
        name: microsoftazurecallconnectionscreatecall
        description: Microsoft Azure Create A New Call
        call: azure-communication-callingserver-service-callconnection.microsoftazurecallconnectionscreatecall
        with:
          callRequest: rest.callRequest
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/calling/callconnections/{callconnectionid}/cancelallmediaoperations
      name: calling-callconnections-callconnectionid-cancelallmediaoperations
      description: REST surface for calling-callConnections-callConnectionId-:cancelAllMediaOperations.
      operations:
      - method: POST
        name: microsoftazurecallconnectionscancelallmediaoperations
        description: Microsoft Azure Cancel All Media Operations
        call: azure-communication-callingserver-service-callconnection.microsoftazurecallconnectionscancelallmediaoperations
        with:
          callConnectionId: rest.callConnectionId
          cancelAllMediaOperationRequest: rest.cancelAllMediaOperationRequest
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/calling/callconnections/{callconnectionid}/hangup
      name: calling-callconnections-callconnectionid-hangup
      description: REST surface for calling-callConnections-callConnectionId-:hangup.
      operations:
      - method: POST
        name: microsoftazurecallconnectionshangupcall
        description: Microsoft Azure Hangup The Call
        call: azure-communication-callingserver-service-callconnection.microsoftazurecallconnectionshangupcall
        with:
          callConnectionId: rest.callConnectionId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/calling/callconnections/{callconnectionid}/playaudio
      name: calling-callconnections-callconnectionid-playaudio
      description: REST surface for calling-callConnections-callConnectionId-:playAudio.
      operations:
      - method: POST
        name: microsoftazurecallconnectionsplayaudio
        description: Microsoft Azure Play Audio In The Call
        call: azure-communication-callingserver-service-callconnection.microsoftazurecallconnectionsplayaudio
        with:
          callConnectionId: rest.callConnectionId
          request: rest.request
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/calling/callconnections/{callconnectionid}/participants
      name: calling-callconnections-callconnectionid-participants
      description: REST surface for calling-callConnections-callConnectionId-participants.
      operations:
      - method: POST
        name: microsoftazurecallconnectionsaddparticipant
        description: Microsoft Azure Add A Participant To The Call
        call: azure-communication-callingserver-service-callconnection.microsoftazurecallconnectionsaddparticipant
        with:
          callConnectionId: rest.callConnectionId
          addParticipantRequest: rest.addParticipantRequest
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/calling/callconnections/{callconnectionid}/participants/{participantid}
      name: calling-callconnections-callconnectionid-participants-participantid
      description: REST surface for calling-callConnections-callConnectionId-participants-participantId.
      operations:
      - method: DELETE
        name: microsoftazurecallconnectionsremoveparticipant
        description: Microsoft Azure Remove A Participant From The Call
        call: azure-communication-callingserver-service-callconnection.microsoftazurecallconnectionsremoveparticipant
        with:
          callConnectionId: rest.callConnectionId
          participantId: rest.participantId
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: azure-communication-callingserver-service-callconnection-mcp
    port: 9090
    transport: http
    description: MCP adapter for Microsoft Azure Azure Communication CallingServer Service — CallConnection. One tool per
      consumed operation, routed inline through this capability's consumes block.
    tools:
    - name: microsoft-azure-create-new-call
      description: Microsoft Azure Create A New Call
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: azure-communication-callingserver-service-callconnection.microsoftazurecallconnectionscreatecall
      with:
        callRequest: tools.callRequest
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-cancel-all-media
      description: Microsoft Azure Cancel All Media Operations
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: azure-communication-callingserver-service-callconnection.microsoftazurecallconnectionscancelallmediaoperations
      with:
        callConnectionId: tools.callConnectionId
        cancelAllMediaOperationRequest: tools.cancelAllMediaOperationRequest
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-hangup-call
      description: Microsoft Azure Hangup The Call
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: azure-communication-callingserver-service-callconnection.microsoftazurecallconnectionshangupcall
      with:
        callConnectionId: tools.callConnectionId
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-play-audio-call
      description: Microsoft Azure Play Audio In The Call
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: azure-communication-callingserver-service-callconnection.microsoftazurecallconnectionsplayaudio
      with:
        callConnectionId: tools.callConnectionId
        request: tools.request
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-add-participant-call
      description: Microsoft Azure Add A Participant To The Call
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: azure-communication-callingserver-service-callconnection.microsoftazurecallconnectionsaddparticipant
      with:
        callConnectionId: tools.callConnectionId
        addParticipantRequest: tools.addParticipantRequest
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-remove-participant-call
      description: Microsoft Azure Remove A Participant From The Call
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: azure-communication-callingserver-service-callconnection.microsoftazurecallconnectionsremoveparticipant
      with:
        callConnectionId: tools.callConnectionId
        participantId: tools.participantId
      outputParameters:
      - type: object
        mapping: $.