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.

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.

August 2024: New and generally available

Education

• Enabled the $orderby query parameter for the following methods:
  • Get educationAssignment
  • Get educationCategory
  • Get educationSubmission
• Reduced support for the $orderby query parameter in the List assignments of a user method to a subset of the properties in the educationAssignment resource.

Employee experience | Employee engagement

Introduced the general availability of the Viva Engage API in Microsoft Graph. A Viva Engage community is a central place for conversations, files, events, and updates for people sharing a common interest or goal. Use the Viva Engage API for the following scenarios:

• Create a community
• Poll for community creation status
• Get a community
• List communities
• Update a community
• Delete a community

People and workplace intelligence | Insights

Get and update user privacy settings for itemInsights and meeting hours insights. Use the userInsightsSettings resource to enable or disable the calculation and visibility of item insights and meeting hours insights for a user.

Reports | Microsoft 365 usage reports

Get or update tenant-wide settings to hide or show identifiable information for users, groups, or sites in Microsoft 365 usage reports.

Teamwork and communications | Online meeting

• Enabled the $select query parameter for the Get callRecording method.
• Enabled the $select query parameter for the Get callTranscript method.
• Enabled the $filter, $select, and $top query parameters for the List recordings method.
• Enabled the $filter, $select, and $top query parameters for the List transcripts method.
• Get all recordings and transcripts from scheduled online meeting instances for which the specified user is the organizer.
• Get a set of recording and transcript resources that were added for online meeting instances organized by the specified user.

Teamwork and communications | Settings

Enabled the Spain and Mexico values as supported regions for the region property of the teamwork and userTeamwork resources.

August 2024: New in preview only

Identity and access | Partner Center security

Introduced the partner security score API. Use this API to generate security scores for partners to help them enhance their posture. The API provides a history of score changes, detailed customer insights, and requirement score information.

Device and app management | Cloud PC

• Use the crossRegionDisasterRecoverySetting property on cloudPcUserSetting to define cross-region disaster recovery settings.
• Deprecated the noLicensesAvailable member on frontlineCloudPcAccessState.

Education

• Enabled the $orderby query parameter for the following methods:
  • Get educationAssignment
  • Get educationCategory
  • Get educationSubmission
• Reduced support for the $orderby query parameter in the List assignments of a user method to a subset of the properties in the educationAssignment resource.

Teamwork and communications | Apps

Use the clientAppId property on teamsAppAuthorization to get the registration ID of the Microsoft Entra app ID associated with an app in the Microsoft Teams app catalog.

Teamwork and communications | Calls and online meetings

• Use the settings property on virtualEventTownhall and virtualEventWebinar to get or set whether attendees receive email notifications for a town hall or webinar.
• Removed the meetingOrganizerId property from the callRecording and callTranscript resources in favor of the meetingOrganizer property.

Teamwork and communications | Messaging

Use the displayName property on the chatMessageReaction resource to represent the reaction name chatMessage.

Teamwork and communications | Online meeting

• Enabled the $select query parameter for the Get callRecording method.
• Enabled the $select query parameter for the Get callTranscript method.
• Enabled the $filter, $select, and $top query parameters for the List recordings method.
• Enabled the $filter, $select, and $top query parameters for the List transcripts method.

Teamwork and communications | Settings

Enabled the Spain and Mexico values as supported regions for the region property of the teamwork and userTeamwork resources.

July 2024: New and generally available

Backup Storage

The new Microsoft 365 Backup Storage API enables partners to build customized versions of their applications that are integrated with the Microsoft 365 Backup Storage platform. This helps to ensure exceptionally fast recovery from typical business continuity and disaster recovery (BCDR) scenarios, such as ransomware attacks or accidental/malicious deletion or overwriting of content by employees. For more information, see Backup Storage.

Customer booking

• Use the createdDateTime and lastUpdatedDateTime properties on bookingAppointment, bookingBusiness, bookingCustomer, bookingCustomQuestion, bookingService, and bookingStaffMember to identify when a related booking resource was created or updated.
• Use the isCustomerAllowedToManageBooking property on bookingAppointment and bookingService to indicate that a customer can manage bookings created by the staff.
• Use the appointmentLabel property on bookingAppointment to get the custom label that can be stamped on an appointment by users.
• Use the customerEmailAddress property on bookingAppointment to get or set the SMTP address of the bookingCustomer who books an appointment.
• Use the customerName property on bookingAppointment to get or set the customer's name.
• Use the customerNotes property on bookingAppointment to get or set the notes from the customer associated with an appointment.
• Use the customerPhone property on bookingAppointment to get or set the customer's phone number.
• Use the bookingPageSettings property on bookingBusiness to get the settings for a published booking page.
• Use the customAvailabilities property on bookingSchedulingPolicy to get the custom availability of a service within a given time frame.
• Use the generalAvailability property on bookingSchedulingPolicy to get the general availability of a service defined by the scheduling policy.
• Use the isMeetingInviteToCustomersEnabled property on bookingSchedulingPolicy to indicate whether a meeting invite is sent to the customers.
• Renamed the startDateTime and endDateTime properties to start and end respectively in the bookingAppointment resource.

Security | Alerts and incidents

Use the summary property to get details about what happened, impacted assets, and the type of attack on an incident.

Teamwork and communications | Calls and online meetings

• Use the settings property on virtualEventWebinar to identify whether attendees receive email notifications.
• Use the callId on callRecording or callTranscript to identify the call that is related to a recording or transcript.
• Use the contentCorrelationId on callRecording or callTranscript to correlate a transcript with its corresponding recording.
• Use the endDateTime on callRecording or callTranscript to identify when a recording or transcript ends.
• Provision approvalSolution and manage approvalItems.

Change notifications

Enabled change notifications support to the methods to list, get, create, update, and delete a subscription for approvalItems in a tenant.

July 2024: New in preview only

Applications | Application

Use the configurationUris property on applicationTemplate to get the URIs required for the single sign-on configuration of a preintegrated application.

Device and app management | Cloud PC

• Use the disasterRecoveryCapability property on cloudPC to get the disaster recovery status of the Cloud PC, including the primary region, secondary region, and capability type.
• 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.

Education

• Deprecated the synchronizationProfiles relationship on the educationRoot, including all types serviced under this endpoint.
• Introduced the Reflect API in Microsoft Graph to get Reflect check-in responses and get reading assignment submissions. Microsoft Reflect helps you create impactful check-ins to gain insights into your learners' well-being and build a happier and healthier learning community, all within a single, user-friendly app.

Identity and access | Directory management

Added the ability to initiate an external admin takeover of an unmanaged domain via the domain-verify API operation.

The following objects are removed:

• cloudPcSharedUseServicePlan resource and its supported methods. Going forward, use the cloudPcFrontLineServicePlan resource.
• sharedUseServicePlans relationship from the virtualEndpoint resource. Going forward, use the frontLineServicePlans relationship.

People and workplace intelligence | Profile

Use the companyCode on companyDetail to get or set the legal entity number of the company or its subdivision.

Security | Alerts and incidents

Use the summary property to get details about what happened, impacted assets, and the type of attack on an incident.

Teamwork and communications | Calls and online meetings

• Use the settings property on virtualEventTownhall and virtualEventWebinar to get or set whether attendees receive email notifications for a town hall or webinar.
• Removed the meetingOrganizerId property from the callRecording and callTranscript resources in favor of the meetingOrganizer property.

Teamwork and communications | Shift management

Added the ability to start and end the working time of a specific user.

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.