Edit

What's new in Microsoft Graph

  • Article

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 2024: New and generally available

Applications

Groups

Added the upsert capability to the group resource type. Use this capability to create a group if it doesn't exist, or update an existing group, by using the uniqueName client-provided key.

Sites and lists

You can now:

Work with site pages and horizonal and vertical sections of pages.

Identity and access | Identity and sign-in

Configure the default identity provider to use in redemption flow settings for Microsoft Entra ID B2B collaboration.

Users

Associate users or groups as sponsors for a guest user's privileges in the tenant and keep the guest user's information and access updated. You can assign a sponsor, list sponsors, and remove a sponsor.

April 2024: New in preview only

Identity and access | Network access

Updated the definition of physical locations for customer premises equipment in the Global Secure Access services from the branchSite resource type to the remoteNetwork resource type. The branchSite resource type and its associated properties, relationships, and endpoints are deprecated will be retired soon. Use the remoteNetwork resource type and its associated properties, relationships, and endpoints.

Industry data ETL

The outbound provisioning flow set, which represents a collection of outbound provisioning flows used to configure how school data sync populates data in Microsoft 365 and Microsoft Entra ID, is now generally available.

An outbound provisioning flow set can contain no more than one of each provisioning flow configuration: userProvisioningFlow, classGroupProvisioingFlow, securityGroupProvisioingFlow, administrativeUnitProvisioingFlow.

When calling the industry data ETL API, take advantage of more granular permissions added for reading or writing outbound provisioning flow set data by using the new permissions IndustryData-OutboundFlow.Read.All and IndustryData-OutboundFlow.ReadWrite.All.

People and workplace intelligence | People

Deprecated the /organization/{organizationId}/settings/itemInsights endpoint in favor of the new peopleAdminSettings resource and introduced the List method on the peopleAdminSettings resource.

Teamwork and communications | Messaging

Send chatMessage in a channel or a chat with a file attachment in it using file share link.

March 2024: New and generally available

Applications

Perform a bulk upload as a synchronization job to ingest data into the Microsoft Entra ID synchronization service.

Cross-device experiences

Added the ability to list and get Windows settings and Windows settings instances.

Device and app management | Cloud PC

  • List, get, end grace period, reboot, rename, restore, and troubleshoot operations are now available on cloudPC.
  • List and get operations are now available on cloudPcAuditEvent.
  • List, get, create, update, delete, and assign provisioning policies operations are now available on cloudPcProvisioningPolicy.
  • List, get, create, update, delete, and assign user settings operations are now available on cloudPcUserSetting.
  • List, get, create, delete, and get source images operations are now available on cloudPcDeviceImage.
  • List and get operations are now available on cloudPcGalleryImage.

Education | Assignment

Enabled the $expand query parameter for the Get educationAssignment method.

Identity and access | Directory management

  • The organization entity now returns the CIAM tenantType to identify tenants that are set up as Microsoft Entra ID for customers tenants, a customer identity & access management (CIAM) solution.
  • New properties set by Intune on the device resource: enrollmentType, isRooted, and managementType.

Reports | Partner billing reports

Use the billedReconciliation: export API to access billed invoice reconciliation data.

March 2024: New in preview only

Security | Attack simulation and training

Use the training campaign API to directly assign security trainings to users.

Applications

Use the upsert capability to create an application, federatedIdentityCredential, or servicePrincipal if it doesn't exist, or update an existing object, by using a client-provided key. For more information, see the following API operations:

Device and app management | Cloud PC

Deprecated the following properties:

Device and app management | Device updates

Added methods to the Windows Updates API for Windows products, including retrieval of known issues by time range, finding product revisions by catalog ID, and by knowledge base number.

Files

Use the Get file by contentStream method to download file content directly instead of getting a 302 redirect URL.

Groups

Added the upsert capability to the group resource type. Use this capability to create a group if it doesn't exist, or update an existing group, by using the uniqueName client-provided key.

Identity and access | Identity and sign-in

Use the federatedTokenValidationPolicy resource type and its associated methods to manage whether Microsoft Entra ID validates federation authentication tokens.

Security | Email and collaboration protection

Added the ability to list emails analyzed by Microsoft Defender for Office 365, get email related metadata, and perform response actions (soft delete, hard delete, move to junk, move to Inbox).

Security | Identities

Added the ability to get, get list, update Microsoft Defender for Identity health issues.

Users

Added the ability to convert an external user to an internal member user using the user: convertExternalToInternalMemberUser API. This conversion allows the converted users to maintain their existing user object and access, while gaining the full privileges of an internal member user in the tenant.

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. Visit the Microsoft 365 and Power Platform community page to discover the full calendar of developer calls.

  • Join our research panel to provide your input on our developer experiences.

Related content