{"id":17916,"date":"2024-01-22T09:51:27","date_gmt":"2024-01-22T17:51:27","guid":{"rendered":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/?p=17916"},"modified":"2024-06-13T10:21:07","modified_gmt":"2024-06-13T17:21:07","slug":"new-microsoft-graph-callrecords-api-capabilities","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/new-microsoft-graph-callrecords-api-capabilities\/","title":{"rendered":"New Microsoft Graph callRecords API capabilities"},"content":{"rendered":"

We are pleased to announce new capabilities for Microsoft Graph <\/strong>callRecords API<\/strong><\/a> in response to some of our top customer requests. Launching in late March, 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 List<\/strong> method<\/a> can be used to list all available call records for your organization. The returned list can be filtered using the $filter<\/strong> parameter to only return records that are relevant to specific search criteria, such as a call participant\u2019s Entra object id <\/strong>or a time range based on a call startDateTime<\/strong>.<\/p>\n

While our existing change notifications<\/a> remain 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 two new objects<\/a> to our call record: participants_v2 <\/strong>and organizer_v2<\/strong>. These new objects, representing a call participant and a call organizer respectively, will now include a user\u2019s User Principal Name<\/strong> for 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 list participants<\/a> in a call.<\/p>\n

Please note that the legacy participant<\/strong> and organizer<\/strong> attributes on the call record object are deprecated with the introduction of these new objects. We will continue supporting these deprecated attributes for a 36-month transition period.<\/p>\n

These changes are now available in Beta and will be generally available worldwide in late March. Support for GCC High and DoD cloud environments will release later this year. We are thrilled to provide these new ways of interacting with the callRecords API and hope you find them useful.<\/span><\/p>\n

Happy coding!<\/p>\n

Resources<\/h2>\n