What's new in Microsoft Graph
Microsoft Graph provides a unified programmability model that you can use to access data in Microsoft 365, Windows, and Enterprise Mobility + Security. This article provides information about what's new in Microsoft Graph APIs, documentation, SDKs, and more.
For more detailed API-level updates, see the Microsoft Graph API changelog.
For details about previous updates to Microsoft Graph, see Microsoft Graph what's new history.
Important
Features in preview status are subject to change without notice, and might not be promoted to generally available (GA) status. Don't use preview features in production apps.
June 2024: New and generally available
Change notifications
Enabled change notifications support to the methods to list, get, create, reauthorize, update, and delete a subscription for offerShiftRequest, openShiftChangeRequest, shift, swapShiftsChangeRequest, and timeOffRequest.
Identity and access | Identity and sign-in
Get or update the cross-tenant access default settings to include cross-tenant access policy tenant restrictions that restrict organization users accessing an external organization on their network or devices.
Files
Permanently delete a fileStorageContainer.
Teamwork and communications | Messaging
Archive or unarchive a channel in a team.
June 2024: New in preview only
Change notifications
Enabled change notifications support to the methods to list, get, create, reauthorize, update, and delete a subscription for offerShiftRequest, openShiftChangeRequest, shift, swapShiftsChangeRequest, and timeOffRequest.
Device and app management | Cloud PC
- Removed the type property from the cloudPcAuditResource resource. Going forward, use the resourceType property.
- Use the deviceRegionName property on cloudPC to get the name of the geographical region where the Cloud PC is currently provisioned.
Identity and access | Identity and sign-in
- You can now control multifactor authentication (MFA) on an individual user basis, commonly referred to as per-user MFA on the Microsoft Entra admin center, by using the authenticationMethod resource and its associated methods.
- While restoring soft-deleted users, you can now specify whether Microsoft Entra ID should autoreconcile conflicting proxy addresses if one or more of the soft-deleted user's proxy addresses are currently used for an active user.
Identity and access | Network access
You can now enable and control compliant network check with Conditional Access through the Global Secure Access service by using the compliantNetworkNamedLocation resource type and its associated methods.
Sites and lists
Added content model support to sites. You can apply content models to SharePoint document libraries to classify and extract metadata from files. The new APIs enable you to do the following:
- Use Get model or Get model by name methods to get a content model resource.
- Add a content model to a library by using the add to drive method to make it ready to process files.
- Remove a content model from a library by using the remove from drive method.
- Use Get applied drives to list all libraries associated with the content model.
The content model automatically processes new files that are added to the libraries. You can create document processing jobs to process existing files.
Tasks and plans
Assign a sensitivity label to a plannerRoster.
Teamwork and communications | Calls and online meetings
Introduced the ability to list, create, cancel, and list sessions for virtual event meeting registrations.
May 2024: New and generally available
Identity and access | Identity and sign-in
Customize the authentication experience for your customers by using user flows in Microsoft Entra External ID in external tenants. In the self-service sign-up user flow, you can collect user attributes, disable sign-up and only allow sign in, and also integrate with systems that are external to Microsoft Entra ID.
Teamwork and communications | Calls and online meetings
Get the list of callRecord objects and their properties and the associated participant objects for each callRecord using the following APIs:
The following properties are deprecated:
- organizer property on callRecord in favor of the organizer_v2 relationship.
- participants property on callRecord in favor of the participants_v2 relationship.
- identity property on participantEndpoint in favor of the associatedIdentity property.
May 2024: New in preview only
Backup storage
The new Microsoft 365 Backup Storage API enables partners to build customized versions of their applications that are integrated with the Microsoft 365 Backup Storage platform. This helps to ensure exceptionally fast recovery from typical business continuity and disaster recovery (BCDR) scenarios, such as ransomware attacks or accidental/malicious deletion or overwriting of content by employees. To explore the API, see Backup restore root.
Change notifications
- Enabled change notifications support to the methods to list, get, create, reauthorize, update, and delete a subscription for user-scoped chat notifications.
- Enabled the
$notifyOnUserSpecificProperties
query parameter as a value of the resource property in the subscription resource. You can use the notifyOnUserSpecificProperties parameter when you subscribe either to user-scoped chat notifications or notifications in a particular chat.
Device and app management | Cloud PC
Create a snapshot for a specific Cloud PC device.
Deprecated the following methods on the cloudPC resource:
- getCloudPcReviewStatus method; use the retrieveReviewStatus API instead.
- setCloudPcReviewStatus method; use the setReviewStatus API instead.
- resizeCloudPc method; use the resize API instead.
- bulkReprovisionCloudPc method; use the cloudPcBulkReprovision resource and its supported APIs instead.
- bulkRestoreCloudPc method; use the cloudPcBulkRestore resource and its supported APIs instead.
- bulkResize method; use the cloudPcBulkResize resource and its supported APIs instead.
Identity and access | Identity and sign-in
- Use the externalAuthenticationMethodConfiguration resource type and its associated methods to manage the configuration of external authentication methods and define users who can use the external authentication methods to satisfy the second factor of Microsoft Entra ID multifactor authentication requirements.
- Added API operations to retrieve or update keys in an Azure AD B2C Identity Experience Framework (IEF) policy through the new trustFrameworkKey_v2 resource type and its associated methods.
- The custom claims policy API allows application admins to customize the additional claims emitted in tokens affected by this policy. This API enables admins to manage the claims for their application from the Microsoft Entra admin center and by using the Microsoft Graph API interchangeably, allowing more flexibility in their application claims management experience.
Microsoft Graph Bicep templates
Use the new Bicep templates for Microsoft Graph resources to deploy Microsoft Graph resources for your infrastructure as code (IaC) projects. The following Microsoft Graph resources are currently supported as Bicep resource types:
- application
- appRoleAssignedTo
- group
- federatedIdentityCredential
- oauth2PermissionGrant
- servicePrincipal
Microsoft Graph Bicep is currently in preview, but can be used to deploy Microsoft Graph resources that are in v1.0
and beta
.
Search
Use the includeHiddenContent property on the sharePointOneDriveOptions resource to include hidden content, such as archived content and SharePoint Embedded (RaaS), in search results.
Security | eDiscovery
Export results and a report from an ediscoverySearch.
Teamwork and communications | Calls and online meetings
- Get information about a webinar registration configuration.
- List, create, get, update, and delete presenters on a virtualEventWebinar.
- Use the callId on callRecording or callTranscript to identify the call that is related to a recording or transcript.
- Use the contentCorrelationId on callRecording or callTranscript to correlate a transcript with its corresponding recording.
- Use the endDateTime on callRecording or callTranscript to identify when a recording or transcript ends.
Teamwork and communications | Messaging
- Use the reactionContentUrl property on chatMessageReaction to represent the hosted content URL for a custom reaction in a chatMessage.
- Use the
<customemoji></customemoji>
tag on the content property of the itemBody resource to represent custom emojis in the message body in a chatMessage. - Use the isHiddenForAllMembers property to indicate whether a chat is hidden from all its members.
- Use the createdBy property on chat to retrieve the entity that created the chat.
Contribute to Microsoft Graph
Are there scenarios you'd like Microsoft Graph to support?
Suggest and vote for new features by using the Microsoft Graph Feedback Portal. Some new features originate as popular requests from the developer community. The Microsoft Graph team regularly evaluates customer needs and releases new features to the beta (
https://graph.microsoft.com/beta
) and v1.0 (https://graph.microsoft.com/v1.0
) endpoints.Join the weekly Microsoft 365 platform community call and become an active member of the Microsoft Graph community. To discover the full calendar of developer calls, visit the Microsoft 365 and Power Platform community page.
Join our research panel to provide your input on our developer experiences.
Related content
Feedback
https://aka.ms/ContentUserFeedback.
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see:Submit and view feedback for