Calls.JoinGroupCall.All

Allows the app to join group calls and scheduled meetings in your organization, without a signed-in user. The app will be joined with the privileges of a directory user to meetings in your organization.

Merill's Note

For an app to access data in Microsoft Graph, the user or administrator must grant it the permissions it needs. This article lists all the Microsoft Graph APIs and your tenant data that can be accessed by the application (vendor/developer) if you consent to the Calls.JoinGroupCall.All permission.

If you need to create an audit report of the permissions granted to all the apps in your tenant, you can run the Export-MsIdAppConsentGrantReport command. See How To: Run a quick OAuth app audit of your tenant

Category	Application	Delegated
Identifier	f6b49018-60ab-4f81-83bd-22caeabfed2d	-
DisplayText	Join group calls and meetings as an app	-
Description	Allows the app to join group calls and scheduled meetings in your organization, without a signed-in user. The app will be joined with the privileges of a directory user to meetings in your organization.	-
AdminConsentRequired	-	-

Graph Methods

→ API supports delegated access (access on behalf of a user)
→ API supports app-only access (access without a user)

	Methods
	DELETE /app/calls/{id}/audioRoutingGroups/{id}
	DELETE /communications/calls/{id}/audioRoutingGroups/{id}
	GET /app/calls/{id}/audioRoutingGroups
	GET /app/calls/{id}/audioRoutingGroups/{id}
	GET /communications/calls/{id}/audioRoutingGroups
	GET /communications/calls/{id}/audioRoutingGroups/{id}
	GET /communications/calls/{id}/contentSharingSessions
	GET /communications/calls/{id}/contentSharingSessions/{id}
	GET /communications/calls/{id}/participants/{id}
	PATCH /app/calls/{id}/audioRoutingGroups/{id}
	PATCH /communications/calls/{id}/audioRoutingGroups/{id}
	POST /app/calls/{id}/addLargeGalleryView
	POST /app/calls/{id}/audioRoutingGroups
	POST /communications/calls
	POST /communications/calls/{id}/addLargeGalleryView
	POST /communications/calls/{id}/answer
	POST /communications/calls/{id}/audioRoutingGroups
	POST /communications/calls/{id}/participants/{id}/mute
	POST /communications/calls/{id}/participants/{id}/startHoldMusic
	POST /communications/calls/{id}/participants/{id}/stopHoldMusic
	POST /communications/calls/{id}/updateRecordingStatus
	PS C:> Set-CsApplicationMeetingConfiguration -AllowRemoveParticipantAppIds @{Add="app_id"}

→ API supports delegated access (access on behalf of a user)
→ API supports app-only access (access without a user)

	Methods
	DELETE /app/calls/{id}/audioRoutingGroups/{id}
	DELETE /communications/calls/{id}/audioRoutingGroups/{id}
	GET /app/calls/{id}/audioRoutingGroups
	GET /app/calls/{id}/audioRoutingGroups/{id}
	GET /app/calls/{id}/participants/{id}
	GET /communications/calls/{id}/audioRoutingGroups
	GET /communications/calls/{id}/audioRoutingGroups/{id}
	GET /communications/calls/{id}/contentSharingSessions
	GET /communications/calls/{id}/contentSharingSessions/{id}
	GET /communications/calls/{id}/participants/{id}
	PATCH /app/calls/{id}/audioRoutingGroups/{id}
	PATCH /communications/calls/{id}/audioRoutingGroups/{id}
	POST /app/calls
	POST /app/calls/{id}/addLargeGalleryView
	POST /app/calls/{id}/answer
	POST /app/calls/{id}/audioRoutingGroups
	POST /app/calls/{id}/participants/{id}/mute
	POST /app/calls/{id}/participants/muteAll
	POST /app/calls/{id}/updateRecordingStatus
	POST /communications/calls
	POST /communications/calls/{id}/addLargeGalleryView
	POST /communications/calls/{id}/answer
	POST /communications/calls/{id}/audioRoutingGroups
	POST /communications/calls/{id}/microsoft.graph.StartRecording
	POST /communications/calls/{id}/microsoft.graph.StartTranscription
	POST /communications/calls/{id}/microsoft.graph.StopRecording
	POST /communications/calls/{id}/microsoft.graph.StopTranscription
	POST /communications/calls/{id}/participants/{id}/mute
	POST /communications/calls/{id}/participants/{id}/startHoldMusic
	POST /communications/calls/{id}/participants/{id}/stopHoldMusic
	POST /communications/calls/{id}/participants/muteAll
	POST /communications/calls/{id}/updateRecordingStatus
	PS C:> Set-CsApplicationMeetingConfiguration -AllowRemoveParticipantAppIds @{Add="app_id"}

→ Command supports delegated access (access on behalf of a user)
→ Command supports app-only access (access without a user)

	Commands
	Add-MgCommunicationCallLargeGalleryView
	Get-MgCommunicationCallAudioRoutingGroup
	Get-MgCommunicationCallContentSharingSession
	Get-MgCommunicationCallParticipant
	Invoke-MgAnswerCommunicationCall
	Invoke-MgMuteCommunicationCallParticipant
	New-MgCommunicationCall
	New-MgCommunicationCallAudioRoutingGroup
	Remove-MgCommunicationCallAudioRoutingGroup
	Remove-MgCommunicationCallParticipant
	Start-MgCommunicationCallParticipantHoldMusic
	Stop-MgCommunicationCallParticipantHoldMusic
	Update-MgCommunicationCallAudioRoutingGroup
	Update-MgCommunicationCallRecordingStatus

→ Command supports delegated access (access on behalf of a user)
→ Command supports app-only access (access without a user)

	Commands
	Add-MgBetaCommunicationCallLargeGalleryView
	Get-MgBetaCommunicationCallAudioRoutingGroup
	Get-MgBetaCommunicationCallContentSharingSession
	Get-MgBetaCommunicationCallParticipant
	Invoke-MgBetaAnswerCommunicationCall
	Invoke-MgBetaMuteAllCommunicationCallParticipant
	Invoke-MgBetaMuteCommunicationCallParticipant
	New-MgBetaCommunicationCall
	New-MgBetaCommunicationCallAudioRoutingGroup
	Remove-MgBetaCommunicationCallAudioRoutingGroup
	Remove-MgBetaCommunicationCallParticipant
	Start-MgBetaCommunicationCallParticipantHoldMusic
	Start-MgBetaCommunicationCallRecording
	Start-MgBetaCommunicationCallTranscription
	Stop-MgBetaCommunicationCallParticipantHoldMusic
	Stop-MgBetaCommunicationCallRecording
	Stop-MgBetaCommunicationCallTranscription
	Update-MgBetaCommunicationCallAudioRoutingGroup
	Update-MgBetaCommunicationCallRecordingStatus

Resources

Granting this permission allows the calling application to access (and/or update) the following information in your tenant.

Graph reference: addLargeGalleryViewOperation

Property	Type	Description
clientContext	String	The client context.
id	String	The ID of the server operation. Read-only.
resultInfo	resultInfo	The result information. Read-only.
status	operationStatus	The status of the operation. Possible values are: `notStarted`, `running`, `completed`, `failed`. Read-only.

Property	Type	Description
blob	String	The media configuration blob generated by smart media agent.

Graph reference: audioRoutingGroup

Property	Type	Description
id	string	Read-only.
receivers	collection(string)	List of receiving participant ids.
routingMode	string	Routing group mode. Possible values are: `oneToOne`, `multicast`.
sources	collection(string)	List of source participant ids.

Graph reference: call

Property	Type	Description
callbackUri	String	The callback URL on which callbacks are delivered. Must be an HTTPS URL.
callChainId	String	A unique identifier for all the participant calls in a conference or a unique identifier for two participant calls in a P2P call. This identifier must be copied over from `Microsoft.Graph.Call.CallChainId`.
callOptions	outgoingCallOptions	Contains the optional features for the call.
callRoutes	callRoute collection	The routing information on how the call was retargeted. Read-only.
chatInfo	chatInfo	The chat information. Required information for joining a meeting.
direction	callDirection	The direction of the call. The possible values are `incoming` or `outgoing`. Read-only.
id	String	The unique identifier for the call. Read-only.
incomingContext	incomingContext	Call context associated with an incoming call.
mediaConfig	appHostedMediaConfig or serviceHostedMediaConfig	The media configuration. Required.
mediaState	callMediaState	Read-only. The call media state.
meetingInfo	organizerMeetingInfo, tokenMeetingInfo, or joinMeetingIdMeetingInfo	The meeting information. Required information for meeting scenarios.
myParticipantId	String	Read-only.
requestedModalities	modality collection	The list of requested modalities. Possible values are: `unknown`, `audio`, `video`, `videoBasedScreenSharing`, `data`.
resultInfo	resultInfo	The result information. For example, the result can hold termination reason. Read-only.
source	participantInfo	The originator of the call.
state	callState	The call state. Possible values are: `incoming`, `establishing`, `ringing`, `established`, `hold`, `transferring`, `transferAccepted`, `redirecting`, `terminating`, `terminated`. Read-only.
subject	String	The subject of the conversation.
targets	invitationParticipantInfo collection	The targets of the call. Required information for creating peer to peer call.
toneInfo	toneInfo	Read-only.
transcription	callTranscriptionInfo	The transcription information for the call. Read-only.

Graph reference: chatInfo

Property	Type	Description
messageId	String	The unique identifier of a message in a Microsoft Teams channel.
replyChainMessageId	String	The ID of the reply message.
threadId	String	The unique identifier for a thread in Microsoft Teams.

Graph reference: commsOperation

Property	Type	Description
clientContext	String	Unique Client Context string. Max limit is 256 chars.
ID	String	The operation ID. Read-only.
resultInfo	resultInfo	The result information. Read-only.
status	String	Possible values are: `notStarted`, `running`, `completed`, `failed`. Read-only.

Property	Type	Description
id	String	Unique identifier for the content sharing session. Read-only. Inherited from entity.

Graph reference: identitySet

Property	Type	Description
application	identity	Optional. The application associated with this action.
applicationInstance	identity	Optional. The application instance associated with this action.
conversation	identity	Optional. The team or channel associated with this action.
conversationIdentityType	identity	Optional. Indicates whether the conversation property identifies a team or channel.
device	identity	Optional. The device associated with this action.
encrypted	identity	Optional. The encrypted identity associated with this action.
onPremises	identity	Optional. The on-premises identity associated with this action.
guest	identity	Optional. The guest identity associated with this action.
phone	identity	Optional. The phone number associated with this action.
user	identity	Optional. The user associated with this action.

Graph reference: incomingCallOptions

Property	Type	Description
hideBotAfterEscalation	Boolean	Indicates whether to hide the app after the call is escalated. Inherited from callOptions.
isContentSharingNotificationEnabled	Boolean	Indicates whether content sharing notifications should be enabled for the call. Inherited from callOptions.
isDeltaRosterEnabled	Boolean	Indicates whether delta roster is enabled for the call. Inherited from callOptions.

Graph reference: invitationParticipantInfo

Property	Type	Description
hidden	Boolean	Optional. Whether to hide the participant from the roster.
identity	identitySet	The identitySet associated with this invitation.
participantId	String	Optional. The ID of the target participant.
removeFromDefaultAudioRoutingGroup	Boolean	Optional. Whether to remove them from the main mixer.
replacesCallId	String	Optional. The call which the target identity is currently a part of. For peer-to-peer case, the call will be dropped once the participant is added successfully.

Graph reference: participant

Property	Type	Description
id	String	The participant ID.
info	participantInfo	Information about the participant.
isInLobby	Boolean	`true` if the participant is in lobby.
isMuted	Boolean	`true` if the participant is muted (client or server muted).
mediaStreams	mediaStream collection	The list of media streams.
metadata	String	A blob of data provided by the participant in the roster.
recordingInfo	recordingInfo	Information about whether the participant has recording capability.
removedState	removedState	Indicates the reason why the participant was removed from the roster.
restrictedExperience	onlineMeetingRestricted	Indicates the reason or reasons media content from this participant is restricted.
rosterSequenceNumber	Int64	Indicates the roster sequence number in which the **p

Property	Type	Description
preFetchMedia	mediaInfo collection	The list of media to pre-fetch.

Graph reference: startHoldMusicOperation

Property	Type	Description
clientContext	String	Inherited from commsOperation. Unique client context string. Can have a maximum of 256 characters.
id	String	Inherited from commsOperation. The server operation ID. Read-only.
resultInfo	resultInfo	Inherited from commsOperation. The result information. Read-only.
status	String	Inherited from **c

Graph reference: startRecordingOperation

Property	Type	Description
clientContext	String	Unique client context string. It can have a maximum of 256 characters.
status	String	Possible values are: `notStarted`, `running`, `completed`, `failed`. Read-only.

Graph reference: startTranscriptionOperation

Property	Type	Description
clientContext	String	Unique client context string. It can have a maximum of 256 characters.
status	String	Possible values are: `notStarted`, `running`, `completed`, `failed`. Read-only.

Graph reference: stopHoldMusicOperation

Property	Type	Description
clientContext	String	Inherited from commsOperation. Unique client context string. Can have a maximum of 256 characters.
id	String	Inherited from commsOperation. The server operation ID. Read-only.
resultInfo	resultInfo	Inherited from commsOperation. The result information. Read-only.
status	String	Inherited from **c

Graph reference: stopRecordingOperation

Property	Type	Description
clientContext	String	Unique client context string. It can have a maximum of 256 characters.
status	String	Possible values are: `notStarted`, `running`, `completed`, `failed`. Read-only.

Graph reference: stopTranscriptionOperation

Property	Type	Description
clientContext	String	Unique client context string. It can have a maximum of 256 characters.
status	String	Possible values are: `notStarted`, `running`, `completed`, `failed`. Read-only.

Graph reference: updateRecordingStatusOperation

Property	Type	Description
clientContext	String	Unique client context string. Max limit is 256 chars.
id	String	Read-only.
resultInfo	resultInfo	The result information. Read-only.
status	String	Possible values are: `notStarted`, `running`, `completed`, `failed`.

Table of Contents

Calls.JoinGroupCall.All

Graph Methods

Resources