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.
October 2025: New and generally available
Backup storage
- Use the protectionSources property on driveProtectionUnit, mailboxProtectionUnit, and siteProtectionUnit to get the sources by which a protection unit is currently protected.
- Update a driveProtectionRule or a mailboxProtectionRule.
- Delete and unprotect all the artifacts protected by a dynamic rule in a driveProtectionRule or a mailboxProtectionRule.
October 2025: New in preview only
Device and app management | Cloud PC
- Deprecated the cloudPcExternalPartnerSetting resource and replaced with the cloudPcExternalPartner resource.
- Create, get, or update an external partner of Cloud PC, such as the partner status, and enable or disable the connection.
Education
- List the dependent education assignment resources for a given education assignment resource.
- List the dependent education submission resources for a given education submission resource.
September 2025: New and generally available
Applications
From the end of September 2025, the maximum page size for the List servicePrincipals API will be 100 objects from 999 objects.
Backup storage
Added a note to the artifactCount property of the granularMailboxRestoreArtifact about its upcoming deprecation.
Education
- The assignment service in the education APIs in Microsoft Graph has updated its throttling limits: per app per tenant requests are now limited to 350 per 10 seconds and 10,000 per hour. Per tenant for all apps, the limits are now 700 per 10 seconds and 20,000 per hour. A new limit of 25 requests per 10 seconds is also introduced for POST
/publish
operations. - Get a list of Reading Coach passages that were practiced by a student.
- Get a list of speaker assignments that were submitted by a student.
- Use the educationSpeakerProgressResource to help students gain confidence and reduce anxiety with AI-powered real-time feedback on public speaking skills, such as pace, pitch, and filler words. Speaker Progress also saves educators time and creates more opportunities for independent practice during in-class presentations.
Employee experience | Employee engagement
Use the onlineMeetingEngagementConversation APIs to get all Teams question and answer (Q&A) conversation messages in a tenant and list reactions in an online meeting.
Files
Defined the following endpoints as supported for the driveItem: discardCheckout API:
/drives/{driveId}/items/{itemId}/discardCheckout
/groups/{groupId}/drive/items/{itemId}/discardCheckout
/me/drive/items/{item-id}/discardCheckout
/sites/{siteId}/drive/items/{itemId}/discardCheckout
/users/{userId}/drive/items/{itemId}/discardCheckout
Security | Alerts and incidents
- Added the following new properties to the securityGroupEvidence resource:
- Use the activeDirectoryObjectGuid property to get the unique group identifier assigned by the on-premises Active Directory.
- Use the distinguishedName property to identify the distinguished name of the security group.
- Use the friendlyName property to identify the friendly name of the security group.
- Use the sid property to get the security identifier of the group.
- Use the activeDirectoryObjectGuid property on userAccount to get the unique user identifier assigned by the on-premises Active Directory.
Security | eDiscovery
- Added
holdPolicySync
as a supported value for the action property of the caseOperation and its inherited types. - Use the caseType property on ediscoveryCaseSettings to get or set the type of an eDiscovery case.
- Use the reviewSetSettings property on ediscoveryCaseSettings to get or set the review set settings for a case.
Teamwork and communications | Calls and online meetings
- Removed
inACall
,inAConferenceCall
,inactive
,inAMeeting
,presenting
,urgentInterruptionsOnly
, andoffWork
as supported values for the activity property of presence. - Removed
availableIdle
andbusyIdle
as supported values for the availability property of presence. - Added
focusing
,inACall
,inAMeeting
, andpresenting
as supported values to the availability property of presence. - The throttling limit for the presence resource increased from 1,500 to 10,000 requests per 30 seconds, per application per tenant.
- Use the allowCopyingAndSharingMeetingContent property on onlineMeeting and virtualEventSession to indicate whether the ability to copy and share meeting content is enabled for a meeting or virtual event session.
Teamwork and communications | Messaging
- Create a one-on-one or group chat with installed apps.
- Create a one-on-one or group chat with RSC-granted apps.
September 2025: New in preview only
Backup storage
Added a note to the artifactCount property of the granularMailboxRestoreArtifact about its upcoming deprecation.
Calendars | Places
- The new map APIs in Places enable applications with appropriate read or write permissions to interact with map feature objects. For more information, see Working with the Places API in Microsoft Graph.
- Use the checkInClaim resource to represent the check-in status of an Outlook calendar event booked at a place. For more information see, Create checkInClaim and Get checkInClaim.
Device and app management | Cloud PC
- Added
reserve
as a supported value for the provisioningType property of the cloudPC and cloudPcServicePlan. - Use the createdBy, createdDateTime, lastModifiedBy, and lastModifiedDateTime properties to determine when and by whom a cloudPcProvisioningPolicy was created or modified.
- Added the
cloudPcUserSettingsPersistenceUsageThreshold
,cloudPcDeprovisionedThreshold
, andcloudPcReserveDeprovisionFailedThreshold
as supported values for the conditionCategory property of ruleCondition. - Added the
cloudPcUserSettingsPersistenceScenario
andcloudPcDeprovisionFailedScenario
as supported values for the alertRuleTemplate properties of alertRecord and alertRule. - Use the provisioningSourceType property on cloudPcUserSetting to indicate the provisioning source of the Cloud PC prepared for an end user.
- Use the groupDetail property on cloudPC to get the Microsoft Entra group details associated with a Reserve Cloud PC assignment.
- Use the userDetail property on cloudPC to get the Microsoft Entra user details associated with a Reserve Cloud PC assignment.
Education
- Create a new educationGradingScheme on an educationClass.
- Add an existing educationGradingScheme to an existing educationAssignment.
- Add the default educationGradingScheme to an educationAssignmentSettings object.
Files
- The new SharePoint Embedded migration API enables you to programmatically schedule SharePoint migration jobs for bulk-migrating content from intermediary Azure blob storage containers to the target fileStorageContainer.
- Defined the following endpoints as supported for the driveItem: discardCheckout API:
/drives/{driveId}/items/{itemId}/discardCheckout
/groups/{groupId}/drive/items/{itemId}/discardCheckout
/me/drive/items/{item-id}/discardCheckout
/sites/{siteId}/drive/items/{itemId}/discardCheckout
/users/{userId}/drive/items/{itemId}/discardCheckout
Teamwork and communications | Administration
- Get the policy ID for a given policy name and policy type within Teams administration.
- Assign a Teams policy to a user using the user ID, policy type, and policy ID.
- Unassign a Teams policy from a user using the user ID and policy type.
Teamwork and communications | Administration
Added the telephoneNumberManagementRoot resource that represents a collection of available telephone number management operations.
Teamwork and communications | Calls and online meetings
- Removed
inACall
,inAConferenceCall
,inactive
,inAMeeting
,presenting
,urgentInterruptionsOnly
, andoffWork
as supported values for the activity property of presence. - Removed
availableIdle
andbusyIdle
as supported values for the availability property of presence. - Added
focusing
,inACall
,inAMeeting
, andpresenting
as supported values to the availability property of presence. - The throttling limit for the presence resource increased from 1,500 to 10,000 requests per 30 seconds, per application per tenant.
Security | eDiscovery
Added holdPolicySync
as a supported value for the action property of the caseOperation and its inherited types.
Teamwork and communications | Messaging
- Create a one-on-one or group chat with installed apps.
- Create a one-on-one or group chat with RSC-granted apps.
Workbooks and charts
- Create a new workbookComment.
- Use the cellAddress property on workbookComment to get the cell where the comment is located.
- Use the mentions property on workbookComment or workbookCommentReply to get all the people mentioned within the comment or reply.
- Use the richContent property on workbookComment or workbookCommentReply to get the rich content of the comment or reply.
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.