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:

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

Device and app management | Cloud PC

Create a snapshot for a specific Cloud PC device.

Deprecated the following methods on the cloudPC resource:

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.

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

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.