# Azure Communication Services Call Automation API **Canonical:** https://apis.io/apis/microsoft-azure-communication-services/microsoft-azure-communication-services-callautomation-api/ **Provider:** Microsoft Azure Communication Services — https://apis.io/providers/microsoft-azure-communication-services/ **Base URL:** https://{resource}.communication.azure.com/ **Documentation:** https://learn.microsoft.com/en-us/rest/api/communication/ Azure Communication Services Call Automation API is one of 10 APIs that [Microsoft Azure Communication Services](https://apis.io/providers/microsoft-azure-communication-services/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Voice and Calling. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 6 JSON Schemas. Call Automation API: answer, redirect and create calls, play media, recognize DTMF/speech, record and transfer server-side. 34 operations, data-plane version 2026-03-12, served from the customer's Communication Services resource endpoint. ## Operations (34) | Method | Path | Summary | |---|---|---| | POST | `/calling/callConnections` | Create an outbound call. | | POST | `/calling/callConnections:answer` | Answer a Call. | | POST | `/calling/callConnections:redirect` | Redirect a call. | | POST | `/calling/callConnections:reject` | Reject the call. | | POST | `/calling/callConnections:connect` | Create a Connection to a CallLocator. | | GET | `/calling/callConnections/{callConnectionId}` | Get the detail properties of an ongoing call. | | DELETE | `/calling/callConnections/{callConnectionId}` | Hang up call automation service from the call. This will make call automation service leave the call, but does not terminate if there are more than 1 caller ... | | POST | `/calling/callConnections/{callConnectionId}:terminate` | Terminate a call using CallConnectionId. | | POST | `/calling/callConnections/{callConnectionId}:transferToParticipant` | Transfer the call to a participant. | | POST | `/calling/callConnections/{callConnectionId}:play` | Plays audio to participants in the call. | | POST | `/calling/callConnections/{callConnectionId}:startTranscription` | Starts transcription in the call | | POST | `/calling/callConnections/{callConnectionId}:stopTranscription` | Stops transcription in the call. | | POST | `/calling/callConnections/{callConnectionId}:updateTranscription` | UpdateTranscription Api. | | POST | `/calling/callConnections/{callConnectionId}:cancelAllMediaOperations` | Cancel all media operations in a call. | | POST | `/calling/callConnections/{callConnectionId}:recognize` | Recognize media from call. | | POST | `/calling/callConnections/{callConnectionId}:startContinuousDtmfRecognition` | Start continuous Dtmf recognition by subscribing to tones. | | POST | `/calling/callConnections/{callConnectionId}:stopContinuousDtmfRecognition` | Stop continuous Dtmf recognition by unsubscribing to tones. | | POST | `/calling/callConnections/{callConnectionId}:sendDtmfTones` | Send dtmf tones. | | POST | `/calling/callConnections/{callConnectionId}:hold` | Hold participant from the call using identifier. | | POST | `/calling/callConnections/{callConnectionId}:unhold` | Unhold participants from the call using identifier. | | POST | `/calling/callConnections/{callConnectionId}:startMediaStreaming` | Starts media streaming in the call | | POST | `/calling/callConnections/{callConnectionId}:stopMediaStreaming` | Stops media streaming in the call | | GET | `/calling/callConnections/{callConnectionId}/participants` | Get participants from a call. Recording and transcription bots are omitted from this list. | | POST | `/calling/callConnections/{callConnectionId}/participants:add` | Add a participant to the call. | | POST | `/calling/callConnections/{callConnectionId}/participants:remove` | Remove a participant from the call using identifier. | | POST | `/calling/callConnections/{callConnectionId}/participants:mute` | Mute participants from the call using identifier. | | POST | `/calling/callConnections/{callConnectionId}/participants:cancelAddParticipant` | Cancel add participant operation. | | POST | `/calling/callConnections/{callConnectionId}/participants:moveHere` | Move a participant to the call. | | GET | `/calling/callConnections/{callConnectionId}/participants/{participantRawId}` | Get participant from a call. | | POST | `/calling/recordings` | Start recording the call. | | GET | `/calling/recordings/{recordingId}` | Get call recording properties. | | DELETE | `/calling/recordings/{recordingId}` | Stop recording the call. | | POST | `/calling/recordings/{recordingId}:pause` | Pause recording the call. | | POST | `/calling/recordings/{recordingId}:resume` | Resume recording the call. | ## Machine-readable artifacts (10) - **OpenAPI** — https://artifacts.apis.io/microsoft-azure-communication-services/openapi/microsoft-azure-communication-services-callautomation-api-openapi.yml - **OpenAPI** — https://raw.githubusercontent.com/Azure/azure-rest-api-specs/main/specification/communication/data-plane/CallAutomation/stable/2026-03-12/communicationservicescallautomation.json - **Documentation** — https://learn.microsoft.com/en-us/azure/communication-services/ - **JSONSchema** — https://artifacts.apis.io/microsoft-azure-communication-services/json-schema/microsoft-azure-communication-services-start-call-recording-request-schema.json - **JSONSchema** — https://artifacts.apis.io/microsoft-azure-communication-services/json-schema/microsoft-azure-communication-services-add-participant-request-schema.json - **JSONSchema** — https://artifacts.apis.io/microsoft-azure-communication-services/json-schema/microsoft-azure-communication-services-call-connection-properties-schema.json - **JSONSchema** — https://artifacts.apis.io/microsoft-azure-communication-services/json-schema/microsoft-azure-communication-services-create-call-request-schema.json - **JSONSchema** — https://artifacts.apis.io/microsoft-azure-communication-services/json-schema/microsoft-azure-communication-services-play-request-schema.json - **JSONSchema** — https://artifacts.apis.io/microsoft-azure-communication-services/json-schema/microsoft-azure-communication-services-recognize-request-schema.json - **APIsJSON** — https://artifacts.apis.io/microsoft-azure-communication-services/apis.yml ## Other Microsoft Azure Communication Services APIs (9) - [Azure Communication Services Chat API](https://apis.io/apis/microsoft-azure-communication-services/microsoft-azure-communication-services-chat-api/) - [Azure Communication Services Email API](https://apis.io/apis/microsoft-azure-communication-services/microsoft-azure-communication-services-email-api/) - [Azure Communication Services Identity API](https://apis.io/apis/microsoft-azure-communication-services/microsoft-azure-communication-services-identity-api/) - [Azure Communication Services Job Router API](https://apis.io/apis/microsoft-azure-communication-services/microsoft-azure-communication-services-jobrouter-api/) - [Azure Communication Services Advanced Messaging API](https://apis.io/apis/microsoft-azure-communication-services/microsoft-azure-communication-services-messages-api/) - [Azure Communication Services Phone Numbers API](https://apis.io/apis/microsoft-azure-communication-services/microsoft-azure-communication-services-phonenumbers-api/) - [Azure Communication Services Rooms API](https://apis.io/apis/microsoft-azure-communication-services/microsoft-azure-communication-services-rooms-api/) - [Azure Communication Services SIP Routing API](https://apis.io/apis/microsoft-azure-communication-services/microsoft-azure-communication-services-siprouting-api/) - [Azure Communication Services SMS API](https://apis.io/apis/microsoft-azure-communication-services/microsoft-azure-communication-services-sms-api/) ## Tags Voice, Calling --- Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/microsoft-azure-communication-services/microsoft-azure-communication-services-callautomation-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/microsoft-azure-communication-services/.