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.

December 2025: New and generally available

Calendars | Places

• Use the wifiState property on building to indicate whether a building has Wi-Fi.
• Use the heightAdjustableState property on desk to indicate whether a desk is height adjustable.
• Use the teamsEnabledState property on room to indicate whether a room is enabled for Microsoft Teams.
• Use the placeId property on room and workspace as an alternative immutable unique identifier.
• Use the unavailablePlaceMode resource to indicate why a desk or workspace is marked as unavailable for booking.

Teamwork and communications | Calls and online meetings

• Use the sensitivityLabelAssignment property on onlineMeeting and virtualEventSession to specify the sensitivity label applied to the Teams meeting.
• Use the expiryDateTime property on onlineMeeting and virtualEventSession to indicate the date and time when the meeting resource expires.
• Use the meetingSpokenLanguageTag property on onlineMeeting and virtualEventSession to specify the spoken language used during the meeting for recording and transcription purposes.
• Use the meetingOptionsWebUrl property on onlineMeeting and virtualEventSession to get the URL to the Teams meeting options page for the specified meeting.

Teamwork and communications | Messaging

When $expand=members is included, the List chats API returns a maximum of 25 items, even if a larger $top value is specified.

December 2025: New in preview only

Calendars | Places

Upsert one or more place objects in async mode.

Calendars | Work hours and locations

Manage flexible work hours and locations using the following resources: workHoursAndLocationsSetting, workPlanOccurrence, and workPlanRecurrence. These resources allow you to define recurring and specific work patterns, locations, and time off for modern hybrid scenarios.

Applications

Use the signInAudienceRestrictions property on the application resource to restrict multitenant applications to specific Microsoft Entra tenants. This feature enables organizations to limit application usage to a specific list of allowed tenant IDs, providing enhanced security and compliance controls for multitenant scenarios.

Device and app management | Cloud printing

Use the new supported media sizes in the mediaSizes property of the printerCapabilities resource.

Files

• Use the SharePoint cross-tenant migration task APIs in Microsoft Graph to enable organizations to manage the tasks during tenant-to-tenant migrations. For more information, see sharePointMigrationTask.
• Use the deleted property on sharePointGroupIdentityMapping and sharePointUserIdentityMapping to indicate that an identity mapping was deleted successfully.

Identity and access | Governance

• Use the following resources to represent the data sent to Azure Logic Apps as part of a custom extension callout request when a custom extension in a catalog is used:
  • accessPackageAssignmentCalloutData - for access package assignments
  • accessPackageAssignmentRequestCalloutData - for access package assignment requests
• Added the controlConfiguration resource and the controlConfigurations relationship to the entitlementManagement resource to represent the policies that control lifecycle and access to access packages across the organization.
• Added the entraIdProtectionRiskyUserApproval resource to represent the approval configuration for risky users detected by Microsoft Entra ID Protection.
• Added the insiderRiskyUserApproval resource to represent the approval configuration for risky users detected by Microsoft Purview Insider Risk Management.

Identity and access | Identity and sign-in

Added the microsoftRevokedSessions value to the riskDetail enumeration to indicate that Microsoft revoked sessions. This enumeration member applies to the following Microsoft Entra Identity Protection resources: riskDetection, riskUserActivity, riskyUser, and signIn.

Identity and access | Network access

Customize the block page message displayed to users when Global Secure Access blocks their access to web resources. Use the customBlockPage resource to configure custom messages with limited markdown support.

Mail

• Use the userConfiguration resource and its associated methods to manage user-specific settings, metadata, or application data tied to mailbox folders, using XML, binary, or dictionary formats.
• The callRecord: getPstnCalls API now clarifies that it doesn't return information for Telstra calling plans only.
• The following endpoints are no longer supported for managing user work location:
  • POST /users/{usersId}/presence/clearAutomaticLocation
  • POST /communications/presences/{presenceId}/clearAutomaticLocation
  • POST /users/{usersId}/presence/clearLocation
  • POST /communications/presences/{presenceId}/clearLocation
  • POST /users/{usersId}/presence/setAutomaticLocation
  • POST /communications/presences/{presenceId}/setAutomaticLocation
  • POST /users/{usersId}/presence/setManualLocation
  • POST /communications/presences/{presenceId}/setManualLocation

Teamwork and communications | Calls and online meetings

• When $expand=members is included, the List chats API returns a maximum of 25 items, even if a larger $top value is specified.
• The following endpoints are no longer supported for managing work location for a user:
  • POST /users/{usersId}/presence/clearAutomaticLocation
  • POST /communications/presences/{presenceId}/clearAutomaticLocation
  • POST /users/{usersId}/presence/clearLocation
  • POST /communications/presences/{presenceId}/clearLocation
  • POST /users/{usersId}/presence/setAutomaticLocation
  • POST /communications/presences/{presenceId}/setAutomaticLocation
  • POST /users/{usersId}/presence/setManualLocation
  • POST /communications/presences/{presenceId}/setManualLocation

Teamwork and communications | Messaging

• Get a specific member from the channel allMembers collection. This API provides unified access to both direct and indirect members across all channel types, including shared channels.
• Start the migration of external messages by enabling migration mode in an existing channel.
• Start the migration of external messages by enabling migration mode in an existing chat.
• Complete the migration of external messages by removing migration mode from a chat.
• Use the layoutType property on the channel resource to create channels with different conversation experiences and switch between them at any time. The property supports two values: post for traditional post-reply format and chat for a chat-like threading experience. You can set the layout type when creating a channel and update it later to switch between layouts.

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.