call: mute

Namespace: microsoft.graph

Allows the application to mute itself.

This is a server mute, meaning that the server will drop all audio packets for this participant, even if the participant continues to stream audio.

For more details about how to handle mute operations, see muteParticipantOperation

Note: This method is only supported for group calls.

This API is supported in the following national cloud deployments.

Global service US Government L4 US Government L5 (DOD) China operated by 21Vianet


One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Permission type Permissions (from least to most privileged)
Delegated (work or school account) Not Supported.
Delegated (personal Microsoft account) Not Supported.
Application Calls.Initiate.All, Calls.AccessMedia.All

Note: Permissions are checked when the call is created; no additional permission check is made when calling this API. Calls.AccessMedia.All is only necessary for calls that use app-hosted media.

HTTP request

POST /communications/calls/{id}/mute

Request headers

Name Description
Authorization Bearer {token}. Required.
Content-type application/json. Required.

Request body

In the request body, provide a JSON object with the following parameters.

Parameter Type Description
clientContext String Unique Client Context string. Max limit is 256 chars.


If successful, this method returns a 200 OK response code and a muteParticipantOperation object in the response body.

Note: After this operation returns a successful response, all participants will receive a roster update


The following example shows how to call this API.


The following example shows the request.

Content-Type: application/json

  "clientContext": "clientContext-value"

Note: The response object shown here might be shortened for readability.

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 259

  "@odata.type": "#microsoft.graph.muteParticipantOperation",
  "@odata.context": "$metadata#muteParticipantOperation",
  "id": "17e3b46c-f61d-4f4d-9635-c626ef18e6ad",
  "status": "completed",
  "clientContext": "clientContext-value"
Notification - roster updated with participant muted
Content-Type: application/json
  "@odata.type": "#microsoft.graph.commsNotifications",
  "value": [
      "@odata.type": "#microsoft.graph.commsNotification",
      "changeType": "updated",
      "resourceUrl": "/communications/calls/57dab8b1-894c-409a-b240-bd8beae78896/participants",
      "resourceData": [
          "@odata.type": "#microsoft.graph.participant",
          "id": "2765eb15-01f8-47c6-b12b-c32111a4a86f",
          "info": {
            "identity": {
              "user": {
                "displayName": "Bob",
                "id": "5810cede-f3cc-42eb-b2c1-e9bd5d53ec96"
            "region": "westus",
            "languageId": "en-US"
          "mediaStreams": [
              "mediaType": "audio",
              "label": "main-audio",
              "sourceId": "1",
              "direction": "sendReceive"
          "isMuted": true, // will be set to true on mute
          "isInLobby": false