Microsoft Azure Azure Communication Service Call Automation APIs — MidConnections

naftiko: 1.0.0-alpha2
info:
  label: Microsoft Azure Azure Communication Service Call Automation APIs — MidConnections
  description: 'Microsoft Azure Azure Communication Service Call Automation APIs — MidConnections. 11 operations. Lead operation:
    Microsoft Azure Get Call Connection. Self-contained Naftiko capability covering one Microsoft Azure business surface.'
  tags:
  - Microsoft Azure
  - MidConnections
  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-service-call-automation-apis-midconnections
    baseUri: ''
    description: Microsoft Azure Azure Communication Service Call Automation APIs — MidConnections business capability. Self-contained,
      no shared references.
    resources:
    - name: calling-callConnections-callConnectionId
      path: /calling/callConnections/{callConnectionId}
      operations:
      - name: microsoftazurecallconnectionsgetcall
        method: GET
        description: Microsoft Azure Get Call Connection
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: callConnectionId
          in: path
          type: string
          description: The call connection id.
          required: true
      - name: microsoftazurecallconnectionshangupcall
        method: DELETE
        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-participants
      path: /calling/callConnections/{callConnectionId}/participants
      operations:
      - name: microsoftazurecallconnectionsgetparticipants
        method: GET
        description: Microsoft Azure Get Participants From A 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-participants-participantMri
      path: /calling/callConnections/{callConnectionId}/participants/{participantMri}
      operations:
      - name: microsoftazurecallconnectionsgetparticipant
        method: GET
        description: Microsoft Azure Get Participant From A Call
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: callConnectionId
          in: path
          type: string
          description: The call connection Id
          required: true
        - name: participantMri
          in: path
          type: string
          description: MRI of the participants to retrieve.
          required: true
    - name: calling-callConnections-callConnectionId-participants:add
      path: /calling/callConnections/{callConnectionId}/participants:add
      operations:
      - name: microsoftazurecallconnectionsaddparticipant
        method: POST
        description: Microsoft Azure Add Participants 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: addParticipantsRequest
          in: body
          type: string
          description: The add participants request.
          required: true
        - name: Repeatability-Request-ID
          in: header
          type: string
          description: If specified, the client directs that the request is repeatable; that is, that the client can make
            the request multiple times with the same Repeatability-Reques
        - name: Repeatability-First-Sent
          in: header
          type: string
          description: If Repeatability-Request-ID header is specified, then Repeatability-First-Sent header must also be
            specified. The value should be the date and time at which the
    - name: calling-callConnections-callConnectionId-participants:remove
      path: /calling/callConnections/{callConnectionId}/participants:remove
      operations:
      - name: microsoftazurecallconnectionsremoveparticipants
        method: POST
        description: Microsoft Azure Remove Participant From The Call Using Identifier
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: callConnectionId
          in: path
          type: string
          description: The call connection id.
          required: true
        - name: removeParticipantsRequest
          in: body
          type: string
          description: The participants to be removed from the call.
          required: true
        - name: Repeatability-Request-ID
          in: header
          type: string
          description: If specified, the client directs that the request is repeatable; that is, that the client can make
            the request multiple times with the same Repeatability-Reques
        - name: Repeatability-First-Sent
          in: header
          type: string
          description: If Repeatability-Request-ID header is specified, then Repeatability-First-Sent header must also be
            specified. The value should be the date and time at which the
    - name: calling-callConnections-callConnectionId}:cancelAllMediaOperations
      path: /calling/callConnections/{callConnectionId}:cancelAllMediaOperations
      operations:
      - name: microsoftazurecontentcancelallmediaoperations
        method: POST
        description: Microsoft Azure Cancel All Media Operations In A 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}:play
      path: /calling/callConnections/{callConnectionId}:play
      operations:
      - name: microsoftazurecontentplay
        method: POST
        description: Microsoft Azure Plays Audio To Participants 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: playRequest
          in: body
          type: string
          description: play request payload.
          required: true
    - name: calling-callConnections-callConnectionId}:recognize
      path: /calling/callConnections/{callConnectionId}:recognize
      operations:
      - name: microsoftazurecontentrecognize
        method: POST
        description: Microsoft Azure Recognize Media From Call
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: callConnectionId
          in: path
          type: string
          description: The call connection id
          required: true
        - name: recognizeRequest
          in: body
          type: string
          description: The media recognize request
          required: true
    - name: calling-callConnections-callConnectionId}:terminate
      path: /calling/callConnections/{callConnectionId}:terminate
      operations:
      - name: microsoftazurecallconnectionsterminatecall
        method: POST
        description: Microsoft Azure Terminate A Call Using Callconnectionid
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: callConnectionId
          in: path
          type: string
          description: The terminate call request.
          required: true
        - name: Repeatability-Request-ID
          in: header
          type: string
          description: If specified, the client directs that the request is repeatable; that is, that the client can make
            the request multiple times with the same Repeatability-Reques
        - name: Repeatability-First-Sent
          in: header
          type: string
          description: If Repeatability-Request-ID header is specified, then Repeatability-First-Sent header must also be
            specified. The value should be the date and time at which the
    - name: calling-callConnections-callConnectionId}:transferToParticipant
      path: /calling/callConnections/{callConnectionId}:transferToParticipant
      operations:
      - name: microsoftazurecallconnectionstransfertoparticipant
        method: POST
        description: Microsoft Azure Transfer The Call To A Participant
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: callConnectionId
          in: path
          type: string
          description: The call connection id.
          required: true
        - name: transferToParticipantRequest
          in: body
          type: string
          description: The transfer to participant request.
          required: true
        - name: Repeatability-Request-ID
          in: header
          type: string
          description: If specified, the client directs that the request is repeatable; that is, that the client can make
            the request multiple times with the same Repeatability-Reques
        - name: Repeatability-First-Sent
          in: header
          type: string
          description: If Repeatability-Request-ID header is specified, then Repeatability-First-Sent header must also be
            specified. The value should be the date and time at which the
  exposes:
  - type: rest
    namespace: azure-communication-service-call-automation-apis-midconnections-rest
    port: 8080
    description: REST adapter for Microsoft Azure Azure Communication Service Call Automation APIs — MidConnections. One Spectral-compliant
      resource per consumed operation, prefixed with /v1.
    resources:
    - path: /v1/calling/callconnections/{callconnectionid}
      name: calling-callconnections-callconnectionid
      description: REST surface for calling-callConnections-callConnectionId.
      operations:
      - method: GET
        name: microsoftazurecallconnectionsgetcall
        description: Microsoft Azure Get Call Connection
        call: azure-communication-service-call-automation-apis-midconnections.microsoftazurecallconnectionsgetcall
        with:
          callConnectionId: rest.callConnectionId
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: microsoftazurecallconnectionshangupcall
        description: Microsoft Azure Hangup The Call
        call: azure-communication-service-call-automation-apis-midconnections.microsoftazurecallconnectionshangupcall
        with:
          callConnectionId: rest.callConnectionId
        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: GET
        name: microsoftazurecallconnectionsgetparticipants
        description: Microsoft Azure Get Participants From A Call
        call: azure-communication-service-call-automation-apis-midconnections.microsoftazurecallconnectionsgetparticipants
        with:
          callConnectionId: rest.callConnectionId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/calling/callconnections/{callconnectionid}/participants/{participantmri}
      name: calling-callconnections-callconnectionid-participants-participantmri
      description: REST surface for calling-callConnections-callConnectionId-participants-participantMri.
      operations:
      - method: GET
        name: microsoftazurecallconnectionsgetparticipant
        description: Microsoft Azure Get Participant From A Call
        call: azure-communication-service-call-automation-apis-midconnections.microsoftazurecallconnectionsgetparticipant
        with:
          callConnectionId: rest.callConnectionId
          participantMri: rest.participantMri
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/calling/callconnections/{callconnectionid}/participants-add
      name: calling-callconnections-callconnectionid-participants-add
      description: REST surface for calling-callConnections-callConnectionId-participants:add.
      operations:
      - method: POST
        name: microsoftazurecallconnectionsaddparticipant
        description: Microsoft Azure Add Participants To The Call
        call: azure-communication-service-call-automation-apis-midconnections.microsoftazurecallconnectionsaddparticipant
        with:
          callConnectionId: rest.callConnectionId
          addParticipantsRequest: rest.addParticipantsRequest
          Repeatability-Request-ID: rest.Repeatability-Request-ID
          Repeatability-First-Sent: rest.Repeatability-First-Sent
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/calling/callconnections/{callconnectionid}/participants-remove
      name: calling-callconnections-callconnectionid-participants-remove
      description: REST surface for calling-callConnections-callConnectionId-participants:remove.
      operations:
      - method: POST
        name: microsoftazurecallconnectionsremoveparticipants
        description: Microsoft Azure Remove Participant From The Call Using Identifier
        call: azure-communication-service-call-automation-apis-midconnections.microsoftazurecallconnectionsremoveparticipants
        with:
          callConnectionId: rest.callConnectionId
          removeParticipantsRequest: rest.removeParticipantsRequest
          Repeatability-Request-ID: rest.Repeatability-Request-ID
          Repeatability-First-Sent: rest.Repeatability-First-Sent
        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: microsoftazurecontentcancelallmediaoperations
        description: Microsoft Azure Cancel All Media Operations In A Call
        call: azure-communication-service-call-automation-apis-midconnections.microsoftazurecontentcancelallmediaoperations
        with:
          callConnectionId: rest.callConnectionId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/calling/callconnections/callconnectionid-play
      name: calling-callconnections-callconnectionid-play
      description: REST surface for calling-callConnections-callConnectionId}:play.
      operations:
      - method: POST
        name: microsoftazurecontentplay
        description: Microsoft Azure Plays Audio To Participants In The Call
        call: azure-communication-service-call-automation-apis-midconnections.microsoftazurecontentplay
        with:
          callConnectionId: rest.callConnectionId
          playRequest: rest.playRequest
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/calling/callconnections/callconnectionid-recognize
      name: calling-callconnections-callconnectionid-recognize
      description: REST surface for calling-callConnections-callConnectionId}:recognize.
      operations:
      - method: POST
        name: microsoftazurecontentrecognize
        description: Microsoft Azure Recognize Media From Call
        call: azure-communication-service-call-automation-apis-midconnections.microsoftazurecontentrecognize
        with:
          callConnectionId: rest.callConnectionId
          recognizeRequest: rest.recognizeRequest
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/calling/callconnections/callconnectionid-terminate
      name: calling-callconnections-callconnectionid-terminate
      description: REST surface for calling-callConnections-callConnectionId}:terminate.
      operations:
      - method: POST
        name: microsoftazurecallconnectionsterminatecall
        description: Microsoft Azure Terminate A Call Using Callconnectionid
        call: azure-communication-service-call-automation-apis-midconnections.microsoftazurecallconnectionsterminatecall
        with:
          callConnectionId: rest.callConnectionId
          Repeatability-Request-ID: rest.Repeatability-Request-ID
          Repeatability-First-Sent: rest.Repeatability-First-Sent
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/calling/callconnections/callconnectionid-transfertoparticipant
      name: calling-callconnections-callconnectionid-transfertoparticipant
      description: REST surface for calling-callConnections-callConnectionId}:transferToParticipant.
      operations:
      - method: POST
        name: microsoftazurecallconnectionstransfertoparticipant
        description: Microsoft Azure Transfer The Call To A Participant
        call: azure-communication-service-call-automation-apis-midconnections.microsoftazurecallconnectionstransfertoparticipant
        with:
          callConnectionId: rest.callConnectionId
          transferToParticipantRequest: rest.transferToParticipantRequest
          Repeatability-Request-ID: rest.Repeatability-Request-ID
          Repeatability-First-Sent: rest.Repeatability-First-Sent
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: azure-communication-service-call-automation-apis-midconnections-mcp
    port: 9090
    transport: http
    description: MCP adapter for Microsoft Azure Azure Communication Service Call Automation APIs — MidConnections. One tool
      per consumed operation, routed inline through this capability's consumes block.
    tools:
    - name: microsoft-azure-get-call-connection
      description: Microsoft Azure Get Call Connection
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: azure-communication-service-call-automation-apis-midconnections.microsoftazurecallconnectionsgetcall
      with:
        callConnectionId: tools.callConnectionId
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-hangup-call
      description: Microsoft Azure Hangup The Call
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: azure-communication-service-call-automation-apis-midconnections.microsoftazurecallconnectionshangupcall
      with:
        callConnectionId: tools.callConnectionId
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-get-participants-call
      description: Microsoft Azure Get Participants From A Call
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: azure-communication-service-call-automation-apis-midconnections.microsoftazurecallconnectionsgetparticipants
      with:
        callConnectionId: tools.callConnectionId
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-get-participant-call
      description: Microsoft Azure Get Participant From A Call
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: azure-communication-service-call-automation-apis-midconnections.microsoftazurecallconnectionsgetparticipant
      with:
        callConnectionId: tools.callConnectionId
        participantMri: tools.participantMri
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-add-participants-call
      description: Microsoft Azure Add Participants To The Call
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: azure-communication-service-call-automation-apis-midconnections.microsoftazurecallconnectionsaddparticipant
      with:
        callConnectionId: tools.callConnectionId
        addParticipantsRequest: tools.addParticipantsRequest
        Repeatability-Request-ID: tools.Repeatability-Request-ID
        Repeatability-First-Sent: tools.Repeatability-First-Sent
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-remove-participant-call
      description: Microsoft Azure Remove Participant From The Call Using Identifier
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: azure-communication-service-call-automation-apis-midconnections.microsoftazurecallconnectionsremoveparticipants
      with:
        callConnectionId: tools.callConnectionId
        removeParticipantsRequest: tools.removeParticipantsRequest
        Repeatability-Request-ID: tools.Repeatability-Request-ID
        Repeatability-First-Sent: tools.Repeatability-First-Sent
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-cancel-all-media
      description: Microsoft Azure Cancel All Media Operations In A Call
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: azure-communication-service-call-automation-apis-midconnections.microsoftazurecontentcancelallmediaoperations
      with:
        callConnectionId: tools.callConnectionId
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-plays-audio-participants
      description: Microsoft Azure Plays Audio To Participants In The Call
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: azure-communication-service-call-automation-apis-midconnections.microsoftazurecontentplay
      with:
        callConnectionId: tools.callConnectionId
        playRequest: tools.playRequest
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-recognize-media-call
      description: Microsoft Azure Recognize Media From Call
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: azure-communication-service-call-automation-apis-midconnections.microsoftazurecontentrecognize
      with:
        callConnectionId: tools.callConnectionId
        recognizeRequest: tools.recognizeRequest
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-terminate-call-using
      description: Microsoft Azure Terminate A Call Using Callconnectionid
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: azure-communication-service-call-automation-apis-midconnections.microsoftazurecallconnectionsterminatecall
      with:
        callConnectionId: tools.callConnectionId
        Repeatability-Request-ID: tools.Repeatability-Request-ID
        Repeatability-First-Sent: tools.Repeatability-First-Sent
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-transfer-call-participant
      description: Microsoft Azure Transfer The Call To A Participant
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: azure-communication-service-call-automation-apis-midconnections.microsoftazurecallconnectionstransfertoparticipant
      with:
        callConnectionId: tools.callConnectionId
        transferToParticipantRequest: tools.transferToParticipantRequest
        Repeatability-Request-ID: tools.Repeatability-Request-ID
        Repeatability-First-Sent: tools.Repeatability-First-Sent
      outputParameters:
      - type: object
        mapping: $.