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.

January 2025: New in preview only

Device and app management | Cloud PC

• Retry a bulk action with selected Cloud PCs.
• Use the productType property on cloudPC to get the product type of a Cloud PC or to filter Cloud PCs by product type.

Identity and access | Directory management

• Use the alternativeNames property on device to get or set alternative names for a device.
• Use the deviceTemplate resource and its associated methods to manage device templates for devices in Microsoft Entra ID.
• Use the mutualTlsOauthConfiguration resource and its associated methods to manage certificate authorities that are permitted to issue certificates for a specific set of objects used for mTLS.

Identity and access | Identity and sign-in

Added support for configuring a custom email provider for one-time passcodes (OTP) in Microsoft Entra External ID by using the following objects:

• The onOtpSendCustomExtension resource type to configure the custom authentication extension that contains configuration details of the external service that might be an Azure Function.
• The onEmailOtpSendListener resource type to configure the event listener that is triggered to send the OTP prompt to the user, based on the configuration details in the onOtpSendCustomExtension object.

The functionality also allows you to configure the default fallback option when the custom authentication extension isn't successfully called.

Industry data ETL

Use the start operation on the industryDataRun resource to perform an on-demand run, with throttling limits of up to five successful runs every 12 hours.

Tasks and plans

Use the teamsChannel container type to create plans in shared channels in Microsoft Teams.

December 2024: New and generally available

Reports

Microsoft Graph activity logs, which provide an audit trail of all HTTP requests that Microsoft Graph received and processed for your tenant, are now available in China operated by 21Vianet.

Security | Alerts and incidents

Enabled the description, displayName, resolvingComment, and severity properties as supported properties in an Update incident request.

Teamwork and communications | Calls and online meetings

• Use the following new methods for virtual events that are of the virtualEventTownhall type:
  • List all virtual event town halls created in a tenant.
  • Get the virtual event town halls where a specified user is an organizer or coorganizer.
  • Get the virtual event town halls where the signed-in user is an organizer or coorganizer.
• Link external event information to a virtualEventTownhall or virtualEventWebinar by setting an externalEventId.
• Use the externalEventInformation on virtualEventTownhall and virtualEventWebinar to identify the external event information of a virtual event.
• Use the externalRegistrationInformation property on virtualEventRegistration to get or set the external information for a virtual event registration.

Teamwork and communications | Shift management

• Stage the deletion of an openShift, shift, or timeOff instance in a schedule in draft mode.
• Use the eligibilityFilteringEnabledEntities property on workforceIntegration to get or set support for viewing eligibility-filtered results.

Users

Published the following lesser privileged permissions for managing specific scenarios on the user object:

December 2024: New in preview only

Backup Storage

Use the new restore bulk addition request API for more convenient, efficient, and scalable restore solutions. This API is designed to streamline the restore process by allowing direct submission of restoration resources in a bulk request. The following resources are supported:

• driveRestoreArtifactsBulkAdditionRequest
• mailboxRestoreArtifactsBulkAdditionRequest
• siteRestoreArtifactsBulkAdditionRequest

Device and app management | Cloud PC

• Use the disasterRecoveryType property on cloudPcCrossRegionDisasterRecoverySetting to get or set the type of disaster recovery to perform when a disaster occurs on a user's Cloud PC.
• Use the userInitiatedDisasterRecoveryAllowed property on cloudPcCrossRegionDisasterRecoverySetting to get or set whether the client allows the end user to initiate a disaster recovery activation.
• Deprecated the crossRegionDisasterRecoveryEnabled property of the cloudPcCrossRegionDisasterRecoverySetting resource. Going forward use the disasterRecoveryType property.
• Enabled endpointConnectivityCheckVMAgentEndPointCommunicationError as a supported error type in the errorType property of the cloudPcOnPremisesConnectionHealthCheck resource.

Identity and access | Directory management

While restoring soft-deleted users, you can now specify whether Microsoft Entra ID should replace the user's userPrincipalName with a new value.

Identity and access | Identity and sign-in

• Use Microsoft Graph APIs to stay informed about the latest product updates, including the product roadmap and change announcements, the programmatic alternative to the What's new tab on the Microsoft Entra admin center.
• You can now manage hardware OATH tokens for your organization and users programmatically via the following Microsoft Graph APIs:
  • hardwareOathTokenAuthenticationMethodDevice resource type and its associated methods to manage the hardware tokens in your tenant, including assigning to users
  • hardwareOathAuthenticationMethod resource type and its associated methods to manage tokens that are already assigned to users by activating or deactivating them

Reports | Microsoft 365 monitoring reports

The Microsoft 365 monitoring APIs provide telemetry data to monitor the health of various Microsoft services within a Microsoft 365 subscription for your organization. Use the new operations in the serviceActivity resource to get telemetry data for Exchange Online, Microsoft 365 Apps, and Microsoft Teams.

Security | Alerts and incidents

Enabled the description, displayName, and severity properties as supported properties in an Update incident request.

Sites and lists

• Create and manage a news link page in SharePoint.
• Archive or unarchive a SharePoint site.

Teamwork and communications | Calls and online meetings

The get and list operations of the callRecording and callTranscript resources support the retrieval of call recordings or call transcripts from private chat meetings and channel meetings.

Teamwork and communications | Messaging

Use the firstChannelName property on team to set the name of the first channel created in a team.

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

• Microsoft Graph developer blog.
• Microsoft Graph API changelog.
• Microsoft Graph what's new history.