Item insights admin settings path and scope change in Microsoft Graph

Jonas Lintvedt

November 10th, 20230 0

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/itemInsights to https://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.