What's new in Microsoft Graph
See highlights of what's new in the recent two months in Microsoft Graph, what's added earlier, and how you can share your ideas. For a detailed list of API-level updates, see the API changelog.
Important
Features, including APIs and tools, in preview status may change without notice, and some may never be promoted to generally available (GA) status. Do not use preview features in production apps.
August 2023: New and generally available
Applications
Enable or disable the lock configuration of sensitive properties of a multi-tenant application for editing after the application is provisioned in a tenant.
Education
Create a class assignment using an application permission without a signed-in user present.
Identity and access | Directory management
Use the application permission OnPremDirectorySynchronization.Read.All or OnPremDirectorySynchronization.ReadWrite.All to read or update on-premises directory synchronization functionalities that are available for an organization, without a signed-in user present.
Security | Alerts and incidents
Manage additional resources, such as a Kubernetes account or service, or a storage blob or blob container, as specific types of evidence related to an alert. See an exact list of evidence types added.
Teamwork and communications | Apps
- List each resource-specific permission grant on a specific chat, showing each Azure AD app that has access to the chat, the permission type, and actual resource-specific permission.
- List each resource-specific permission grant on a specific team, showing each Azure AD app that has access to the team, the permission type, and actual resource-specific permission.
August 2023: New in preview only
Applications
Set as part of authentication behaviors a requirement that a multi-tenant resource application should have a service principal in the resource tenant before the application is granted access tokens.
Device and app management | Cloud PC
- Set up an alert rule by using a rule template for a grace period scenario. This type of an alert rule triggers an alert on the Microsoft Endpoint Manager admin center when a license or assignment change happens to the user and the Cloud PC enters a grace period. For more information about Cloud PC grace periods, see Device management overview for Cloud PCs.
- Get informational status from the most recent health check on an on-premises network connection between a Cloud PC and Azure, involving Cloud PC add-on features such as single sign-on. This information is intended to optimize the user experience and does not affect the provisioning of the customer's Cloud PC.
Device and app management | Multi-tenant management
Get the license type of a specified managed tenant as part of the Azure Active Directory credential user registration, for example, AADFree, AADPremium1, AADPremium2.
Education
Organize individual learning resources in a systematic way in a module. Modules contain read-only learning resources and assignments the teacher wants the student to complete. The teacher can set up a resources folder on SharePoint for a module, pin one module at a time in a classwork list, unpin a module in a classwork list, and publish a module to a student's classwork list.
Identity and access | Identity and sign-in
- Use a session control that requires sign-in sessions to be bound to a device.
- Use hardware OATH authentication method policy to sign in and perform multi-factor authentication (MFA) in Azure Active Directory (Azure AD).
- Use a new form of cross-tenant collaboration, multi-tenant organization, to enable multiple tenants in Azure Active Directory to collaborate seamlessly as a single entity. Set up and manage a multi-tenant organization, and configure cross-tenant policies for multi-tenant organization tenants through policy templates. For more information, see multi-tenant organization API overview.
People and workplace intelligence | People
- Use the delegated permission,
PeopleSettings.Read.AllorPeopleSettings.ReadWrite.All, to read or update people-related admin settings that are available for an organization, with a signed-in user present. - Use the policy-based application permission,
PeopleSettings.Read.AllorPeopleSettings.ReadWrite.All, to read or update people-related admin settings that are available for an organization, without a signed-in user present.
Reports | Identity and access reports
Get information about the managed identity used for a sign-in, including its type, associated Azure Resource Manager (ARM) resource ID, and federated token information.
Security | Threat intelligence
List host pair information for a host to reveal connections between websites, where your resources are being used and vice-versa, and adversaries’ infrastructure of actor groups targeting your organization. A host pair is two pieces of infrastructure (a parent and a child), leveraging the relationship of which can build out a threat investigation. For more information, see infrastructure chaining, data sets, and host pairs.
Teamwork and communications | Calls and online meetings
- Get a specific call recording for an online meeting for which the specified user is an organizer or participant.
- List all recordings of an online meeting for which the specified user is an organizer or participant.
- Get all recordings from scheduled online meeting instances for which the specified user is the organizer.
- Get a set of recording resources that have been added for online meeting instances organized by the specified user.
- List all virtual event sessions for a webinar virtual event.
Users
- Get all on-premises Session Initiation Protocol (SIP) information related to a user.
- Get information related to Microsoft real-time communications for a user.
July 2023: New and generally available
Calendars
Request a lower privileged delegated or application permission, Calendar.ReadBasic, for most read operations for events in calendars, with or without a signed-in user present. This permission allows an app to read events of all calendars, except for properties such as body, attachments, and extensions. For the exact list of operations that support these permissions, see the July updates for Calendar.
Device and app management | Cloud printing
Get the printer name in reports for archived print jobs and printer usage.
Files
Permanently delete a file, folder, or other item stored in OneDrive or SharePoint.
Identity and access | Directory management
- Find tenant information by domain name or by tenant ID.
- Use a number of new properties to configure an organization's branding. For example, custom CSS for the sign-in page, a custom favicon with a CDN-based URL, custom link text and URL for "Terms of use" and "Privacy and cookies" in the footer, and a few other custom properties for users to manage accounts. For an exact list of these enhancements, see the API changelog.
Identity and access | Governance
- Get information about all custom extension calls that were made during the access package assignment and access package assignment request workflows.
- Use an access package resource request to add a resource to a catalog so that the roles of the resource can be used in one or more access packages in the catalog, update a resource in a catalog to have different attribute requirements, or to remove a resource from a catalog that is no longer needed by the access packages.
Reports | Identity and access reports
- Get a report of the details of the registered authentication methods for a specified user or users in an organization, such as multi-factor authentication, self-service password reset, and passwordless authentication.
- Get a report of the number of users in an organization capable of each of multi-factor authentication, self-service password reset, and passwordless authentication in an organization.
- Get a report of the number of users in an organization registered for each authentication method.
Security | Alerts and incidents
Get the Azure AD user display name for a user account which is involved in mailbox evidence, process evidence, or user evidence related to an alert.
Teamwork and communication | Apps
Support for granting scoped access (also known as resource-specific consent) to an app installed within a chat, team, or the personal scope of a user.
Teamwork and communications | Calls and online meetings
- Create or list audio routing group resources.
- Allow or disallow participants to rename themselves in an instance of an online meeting.
- Set and get the default mode for sharing chat history for an online meeting.
July 2023: New in preview only
Applications | Synchronization
Perform a bulk upload as a synchronization job to ingest data into the Azure AD synchronization service.
Device and app management | Cloud PC
- Get a report for inaccessible Cloud PCs that have failed at least a health check or experienced consecutive user connections failure.
- Use a setting on a Cloud PC to allow or disallow an end user to reset their Cloud PC.
Device and app management | Corporate management
Intune July updates for the beta version.
Identity and access | Directory management
- Get or list one or more of the commercial subscription resources that an organization has acquired. A subscription resource contains the ID and part number of the SKU that it is associated with.
- In a role definition, get one or more types of principals that can be assigned the role, including user, service principal, and group.
Identity and access | Governance
Stop the process of applying a review decision for an instance of a recurring access review created with autoapply and autoreview settings.
Identity and access | Network access
Use the APIs for Microsoft Entra Internet Access and Microsoft Entra Private Access to enable organizations to consolidate controls and configure unified identity and network access policies. Microsoft Entra Internet Access manages access to Microsoft 365, SaaS, and public internet apps while protecting users, devices, and data against internet threats. Microsoft Entra Private Access manages access to private apps hosted on-premises or in the cloud. The two products comprise Microsoft's Security Service Edge solution. For more information on the APIs, see Secure access to cloud, public, and private apps using Microsoft Graph network access APIs.
- Mark an email as junk, adds the sender to the list of blocked senders, and optionally, moves the message to the Junk Email folder.
- Mark an email as not-junk, removes the sender from the list of blocked senders, and optionally, moves the message to the Inbox.
Reports | Identity and access reports
- Get the monthly perentage of authentication availability on Azure Active Directory for a tenant. This data is the tenant's actual attainment as compared with the Azure AD service-level agreement (SLA) which commits to at least 99.99% authentication availability, as described in Azure Active Directory SLA performance.
- Get a log of events for traffic routed through the Global Secure Access services.
- Get all the report components in the Global Secure Access services, including entities summaries, cross-tenant summary, destination summaries, device usage summary, and transaction summaries.
Security | Alerts and incidents
- When getting alerts, in addition to the previously supported types of detection technology and services, you can now identify Microsoft Defender for Cloud as the technology that detected a specific alert, or service that created the alert.
- When getting alerts, in addition to previously supported types of evidence, you can now differentiate evidence resources of the following types: Amazon resource evidence, Azure resource evidence, or Google resource evidence.
Sites and lists
- For a standard web part contained in a rich text web part, get the ID of the container text web part.
- Create, update, or delete a horizontal section on a SharePoint page.
- Create, update, or delete a vertical section on a SharePoint page.
- In addition to getting or listing one or more web part resources on a page, you can now create, update, or delete a web part.
Teamwork and communications | Calls and online meetings
Subscribe to change notifications for transcripts of a specific online meeting, or for transcripts of any online meeting in a tenant.
Teamwork and communications | Devices
Listing teamwork devices now includes SIP analog devices provisioned for the tenant. These SIP analog devices are legacy endpoints such as elevator phones, parking lot phones, or factory floor devices, registered with Microsoft Teams through the SIP Gateway.
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 assisn a sponsor, list sponsors, and remove a sponsor.
Want to stay in the loop?
Here are some ways we can engage:
Are there scenarios you'd like Microsoft Graph to support? Suggest and vote for new features at Microsoft 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 in the following order:
Debut in preview status. Any related REST API updates are in the beta endpoint (
https://graph.microsoft.com/beta).Promoted to general availability (GA) status, if sufficient feedback indicates viability. Any related REST API updates are added to the v1.0 endpoint (
https://graph.microsoft.com/v1.0).
Be an active member in the Microsoft Graph community! Join the weekly Microsoft 365 platform community call.
Sign up for the Microsoft 365 developer program, get a free Microsoft 365 subscription, and start developing!
See also
- Check out the Microsoft Graph developer blog periodically for release announcements and helpful resources.
- Browse details of Microsoft Graph API additions, and API behavior updates in the changelog.
- Find highlights of earlier releases.
- Learn more about versioning, support, and breaking change policies for Microsoft Graph.
Feedback
Submit and view feedback for