Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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.
April 2025: New and generally available
Identity and access | Identity and sign-in
Use the following supported attribute events:
- Authentication event listeners
- Custom authentication extensions
- User flows in external tenants
Teamwork and communications | Calls and online meetings
- The basicServiceSetIdentifier property on networkInfo isn't available if the user disables precise location sharing in their operating system or Microsoft Teams app settings.
- Known issues related to application identities and missing participants are associated with List participants_v2 and participant.
- Updated the throttling information for virtualEvent. You can now perform 750
GET
requests per app across all tenants in a 30-second period, and 15Create
,Update
, andDelete
requests per app across all tenants in a 30-second period, instead of the 10,000 requests per app each month.
April 2025: New in preview only
Cross-device experiences
Delete all windowsSetting objects of a user.
Device and app management | Cloud licensing
Updated the permissions for the List usageRights for user and Get usageRight APIs.
Files
Added the forceInfectedDownload
as a supported prefer header to the Get content and Get contentStream methods to enable the download of infected files when specifically requested.
Teamwork and communications | Administration
Get or list user configurations for users with accounts in the Teams context.
Reports | Partner billing reports
Export unbilled invoice reconciliation data.
Identity and access | Identity and sign-in
Added onAttributeCollectionStartListener and onAttributeCollectionSubmitListener as supported authenticationEventListener.
Reports | Identity and access reports
Use the serviceActivity: getMetricsForConditionalAccessBlockedSignIn to get the number of user sign-in attempts that were blocked by a Conditional Access policy during a specific period.
Reports | Microsoft 365 usage reports
Use the getApiUsage API to get the tenant-level daily API usage report that provides information about active Microsoft Graph API usage across specific service areas (Microsoft Exchange, Microsoft Teams Messaging, Microsoft Teams Calling, or Microsoft Teams Presence) or all supported service areas.
Tasks and plans
Use the plannerTask container type to create a new plan in the container of a Planner task.
Teamwork and communications | Calls and online meetings
- The basicServiceSetIdentifier property on networkInfo isn't available if the user disables precise location sharing in their operating system or Microsoft Teams app settings.
- Known issues related to application identities and missing participants are associated with List participants_v2 and participant.
- Updated the throttling information for virtualEvent. You can now perform 750
GET
requests per app across all tenants in a 30-second period, and 15Create
,Update
, andDelete
requests per app across all tenants in a 30-second period, instead of the 10,000 requests per app each month. - Use the isInteractiveRosterEnabled property on incomingCallOptions and outgoingCallOptions to indicate whether delta roster filtering by participant interactivity is enabled. Use the videoOnDemandWebUrl property on virtualEventSession, which provide the URL of the video on demand (VOD) for Microsoft Teams events that allows webinar and town hall organizers to quickly publish and share event recordings.
Teamwork and communications | Messaging
Use the iconId property on the teamwork: sendActivityNotificationToRecipients, userTeamwork: sendActivityNotification, chat: sendActivityNotification, and team: sendActivityNotification to send activity notifications with customized icons.
Device and app management | Cloud PC
Use the new groupBy parameter in the retrieveCloudPcTroubleshootReports method to specify the columns that define how to group the data in the report.
March 2025: New and generally available
Teamwork and communications | Messaging
Applications
Updated the Microsoft Entra built-in role required to perform a new bulk upload. Going forward, admin users can use the User Administrator role instead of the Global Administrator role to invoke this API.
Device and app management | Cloud PC
Use the autopatch property on cloudPcProvisioningPolicy to get or set specific settings for Windows Autopatch that enable its customers to experience it on Cloud PC.
Files
Use the app folder in OneDrive and SharePoint for secure application settings and data storage with Microsoft Graph.
Identity and access | Identity and sign-in
- Deprecated the following resources and their associated APIs that support the Microsoft Entra lifecycle announcements APIs. The APIs will stop returning data in May 2025. Use the Microsoft Entra release notes RSS feed instead.
- Use the applicationFilter property on conditionalAccessApplications to define the dynamic-application-syntax rule to include or exclude cloud applications.
Microsoft Graph connector
The management of Microsoft Graph connectors in the Microsoft Teams admin center will be deprecated on April 14, 2025. Going forward, you can manage Microsoft Graph connectors from the Search & intelligence section in the Microsoft 365 admin center.
Teamwork and communications | Calls and online meetings
Updated the throttling thresholds for the callRecord, participant, and session resources. The limit per call record changed from 10 requests to 40 requests per 20 seconds for all pages, and the limit for list call records changed from 15 requests to 40 requests per 20 seconds for all pages.
Teamwork and communications | Messaging
- Use the firstChannelName property on a team to set the name of the first channel created in a team.
- Enabled Azure China 21Vianet support for the following methods:
Security
Added support for the md5 and sha256Ac file hash algorithms that are now displayed in the fileDetails property of the fileEvidence resource.
March 2025: New in preview only
Applications
Updated the Microsoft Entra built-in role required to perform a new bulk upload. Going forward, admin users can use the User Administrator role instead of the Global Administrator role to invoke this API.
Device and app management | Cloud PC
- Use the healthCheckStatus property on cloudPcSnapshot to indicate the health status of the Cloud PC snapshot.
- Use the ignoreUnhealthySnapshots property on cloudPcBulkRestore to specify whether to ignore snapshots of unhealthy Cloud PCs.
- Removed the
GET /deviceManagement/virtualEndpoint/snapshots/{cloudPcSnapshotId}
method from the cloudPcSnapshot resource. - Use the new members
australasia
andeurope
in cloudPcRegionGroup to indicate the geographic group to which a region belongs. - Use the reportName parameter on the cloudPcReports: retrieveCrossRegionDisasterRecoveryReport method to get the name of the Cloud PC disaster recovery report.
- Added the enabledDRType, dRHealthStatus, and backupCloudPcStatus as supported columns for the cloudPcReports: retrieveCrossRegionDisasterRecoveryReport method and removed the isCrossRegionEnabled and crossRegionHealthStatus columns from the report.
- Perform a bulk disaster recovery action to initiate the failover or failback process for a Cloud PC.
Device and app management | Cloud PC
Use the regionRestrictionDetail property on cloudPcSupportedRegion to get the restriction status of a Cloud PC supported region, including the CPU provisioning status, GPU provisioning status, and nested virtualization provisioning status.
Identity and access | Identity and sign-in
=======
Files
Enabled driveItem as a supported resource for the create, get, update, and delete operations of the openTypeExtension resource. Create and manage sharePointGroup and its members in a SharePoint Embedded container or SharePoint site.
- Get or list long-running operations of a mailFolder.
- Update the read state of all messages in a mailFolder.
Reports | Identity and access reports
Use the linkableIdentifiers property on auditActivityInitiator resource to get a set of linkable claims to link together all the authentication artifacts issued from a single interactive root authentication.
Security
Added support for the md5 and sha256Ac file hash algorithms that are now displayed in the fileDetails property of the fileEvidence resource.
Tasks and plans
Use the publicationName property on plannerTeamsPublicationInfo to get the name of a published task list.
Teamwork and communications | Calls and online meetings
- Use the isEndToEndEncryptionEnabled property on onlineMeeting and virtualEventSession to indicate whether end-to-end encryption (E2EE) is enabled for a meeting or virtual event session.
- Use the call delegation APIs in Microsoft Graph to query and manage delegates and delegators for a user. A delegator grants a delegate the ability to perform actions like making calls or managing settings on their behalf, and the delegate undertakes these tasks. For more information, see Working with the call delegation APIs in Microsoft Graph (preview).
Teamwork and communications | Messaging
- Reply with quote to a single chat message or multiple chat messages in a chat.
- Forward a chat message, a channel message, or a channel message reply to a chat.
- Enabled Azure China 21Vianet support for the following methods:
- Use the
<codeblock><code></code></codeblock>
tag on the content property of the itemBody resource to represent a code block in the message body in a chatMessage
Teamwork and communications | Calls and online meetings
Use the allowCopyingAndSharingMeetingContent on the onlineMeeting and virtualEventSession to indicate whether copying and sharing meeting content is enabled for the meeting.
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.