{"id":23413,"date":"2024-11-13T11:17:07","date_gmt":"2024-11-13T19:17:07","guid":{"rendered":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/?p=23413"},"modified":"2024-11-13T11:17:07","modified_gmt":"2024-11-13T19:17:07","slug":"new-microsoft-graph-callrecords-api-capabilities-in-gcch-and-dod","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/new-microsoft-graph-callrecords-api-capabilities-in-gcch-and-dod\/","title":{"rendered":"New Microsoft Graph callRecords API capabilities in GCCH and DoD"},"content":{"rendered":"

We are excited to share that new capabilities for Microsoft Graph <\/strong>callRecords API<\/strong><\/a> are coming to GCCH and DOD environments in December. <\/strong>As we described earlier this year<\/a>, these new capabilities will simplify and expand the ways developers can access call records by listing and filtering available records. The callRecords API provides usage and diagnostic information about the calls and online meetings that occur within your organization when using Microsoft Teams or Skype for Business.<\/p>\n

List and filter call records<\/h2>\n

A new\u00a0List<\/strong>\u00a0method<\/a>\u00a0can be used to list all available call records for your organization. The returned list can be filtered using the\u00a0$filter<\/strong>\u00a0parameter to only return records that are relevant to specific search criteria, such as a call participant\u2019s\u00a0Entra object id\u00a0<\/strong>or a time range based on a call\u00a0startDateTime<\/strong>.<\/p>\n

While our existing\u00a0change notifications<\/a>\u00a0remain available for consumers to receive notifications as new call records are available, the new list functionality provides an easy way to fetch all available records on-demand and simplifies the process of retrieving call records that include specific participants or that occur during a specific time range.<\/p>\n

Participant and organizer changes<\/h2>\n

As a part of this change, we are introducing\u00a0two new objects<\/a> to our call record: participants_v2\u00a0<\/strong>and\u00a0organizer_v2<\/strong>. These new objects, representing a call participant and a call organizer respectively, will now include a user\u2019s\u00a0User Principal Name<\/strong>\u00a0for additional context on user identity. Additionally, participants_v2 is now expandable and paginated to fully reflect all users in large meetings and includes a dedicated method to\u00a0list participants<\/a>\u00a0in a call.<\/p>\n

Please note that the legacy\u00a0participant<\/strong>\u00a0and\u00a0organizer<\/strong>\u00a0attributes on the call record object are deprecated with the introduction of these new objects. We are also deprecating the identity<\/strong> attribute on the participantEndpoint<\/strong> object, which will be replaced by a new associatedIdentity<\/strong> attribute. We will continue supporting these deprecated attributes for a 36-month transition period.<\/p>\n

These changes are currently in beta and will be released to v1.0 in GCCH and DOD environments in mid-December.<\/p>\n

Happy coding!<\/p>\n

Resources<\/h2>\n