We’re announcing several changes to the calls and online meetings APIs in Microsoft Graph beta, including a few breaking changes. Changes might affect existing applications that use the /beta calls and online meetings APIs. We expect the breaking change to be fully deployed by the middle of July 2019.

call entity updates

Adding new property mediaState to the call entity

We’re adding a new mediaState property to the call entity. This new property will include the activeness info of different modalities.

The microsoft.graph.callMediaState is a new complex type with one property: audio.

The microsoft.graph.mediaState is a new enum with two values.

Adding new property to complex type meetingCapability

Renaming property error and ringningTimeoutInSeconds

Add value to enum routingPolicy and make this enum extensible

The enum routingPolicy is now extensible to be able to add new values in the future.

audioRoutingGroup entity updates

Removing property owner from audioRoutingGroup entity

commsOperation entity updates

Renaming property errorInfo

playPromptOperation Entity

Remove prompts property from playPromptOperation entity

Change type of completionReason property

recordOperation entity update

Remove input parameters from recordOperation

Rename properties

onlineMeeting entity updates

Rename properties in onlineMeeting entity to match Graph specifications.

Remove meetingInfo from onlineMeeting entity

Adding new properties to onlineMeeting entity

New enum meetingCapabilities

New property videoTeleconferenceId

Update enum meetingType (existing enum) (**new from last API review)

Adding new properties to complex type meetingParticipants

Changes to action types

Reject action

Adding new parameter CallbackUri to Reject action, allowing bots to receive notifications at a custom callback for the call after the call is rejected.

Request

The following example shows the request.

POST /app/calls/421f0a00-ba46-45bf-b034-d49ab0961b54/microsoft.graph.reject
Content-Type: application/json; charset=utf-8
{
  "reason": "busy",
  "callbackUri": "https://paywu-bot.frontend.skype-graph-test.net/24701998-1a73-4d42-8085-bf46ed0ae039"
}

HTTP/1.1 202 Accepted

Redirect action

Adding new parameter CallbackUri to redirect action, allowing bots to receive notifications at a custom callback for the call while the call is being redirected.

Play Prompt action

Added loop parameter to specify that this play sequence should be looped indefinitely. This replaces the MediaPrompt.Loop property that allowed bots to specify a loop count but only for a single prompt.