We’re announcing an upcoming breaking change for admins and developers using Microsoft Graph to control item insights settings in a tenant.
About the breaking change
Using the Microsoft Graph API, a tenant admin can enable, disable, and get settings that manage item insights in organization (or specific AAD groups).
Currently, a tenant admin can use Microsoft Graph URL:
https://graph.microsoft.com/beta/organization/{organizationId}/settings/itemInsights which requires the Organization.Read.All or Organization.ReadWrite.All scope.
Starting January 2024, that will change to the new path: https://graph.microsoft.com/beta/admin/people/itemInsights and the scope requirement will also change to PeopleSettings.Read.All and PeopleSettings.ReadWrite.All.
What you need to do to prepare
The following is the summary of the changes that will come to pronouns settings in Microsoft Graph:
- The path would change from
https://graph.microsoft.com/beta/organization/{organizationId}/settings/itemInsightstohttps://graph.microsoft.com/beta/admin/people/itemInsights - The scope required for reading the item insights settings would change from “
Organization.Read.All” to “PeopleSettings.Read.All” - The scope required for updating the item insights settings would change from “
Organization.ReadWrite.All” to “PeopleSettings.ReadWrite.All” - The requirement for Global Administrator role would stay the same.
Please note that this change only affects Microsoft Graph API. This does not impact on the features or functionality of the item insights in Microsoft 365.
Resources
- Customize item insights privacy in Microsoft Graph (preview)
- Follow @Microsoft365Dev / X (Twitter) for the latest news and announcements
0 comments