{"id":16285,"date":"2023-11-10T08:06:58","date_gmt":"2023-11-10T16:06:58","guid":{"rendered":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/?p=16285"},"modified":"2023-11-10T08:06:58","modified_gmt":"2023-11-10T16:06:58","slug":"item-insights-admin-settings-path-and-scope-change-in-microsoft-graph","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/item-insights-admin-settings-path-and-scope-change-in-microsoft-graph\/","title":{"rendered":"Item insights admin settings path and scope change in Microsoft Graph"},"content":{"rendered":"<p aria-level=\"1\"><span data-contrast=\"none\">W<\/span><span data-contrast=\"auto\">e&#8217;re announcing an upcoming breaking change for admins and developers using Microsoft Graph to control item insights settings in a tenant.<\/span><span data-ccp-props=\"{&quot;134233117&quot;:false,&quot;134233118&quot;:false,&quot;201341983&quot;:0,&quot;335559738&quot;:0,&quot;335559739&quot;:0,&quot;335559740&quot;:240}\">\u00a0<\/span><\/p>\n<h2 aria-level=\"2\"><span data-contrast=\"none\">About the breaking change<\/span><span data-ccp-props=\"{&quot;134245418&quot;:true,&quot;134245529&quot;:true,&quot;335559738&quot;:0,&quot;335559739&quot;:0}\">\u00a0<\/span><\/h2>\n<p><span data-contrast=\"auto\">Using the Microsoft Graph API, a tenant admin can enable, disable, and get settings that manage item insights in organization (or specific AAD groups).\u00a0<\/span><span data-ccp-props=\"{&quot;134233117&quot;:false,&quot;134233118&quot;:false,&quot;201341983&quot;:0,&quot;335559738&quot;:0,&quot;335559739&quot;:0,&quot;335559740&quot;:240}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\">Currently, a tenant admin can use Microsoft Graph URL:<\/span><span data-ccp-props=\"{&quot;134233117&quot;:false,&quot;134233118&quot;:false,&quot;201341983&quot;:0,&quot;335559738&quot;:0,&quot;335559739&quot;:0,&quot;335559740&quot;:240}\">\u00a0<\/span><\/p>\n<p><a href=\"https:\/\/graph.microsoft.com\/beta\/organization\/%7borganizationId%7d\/settings\/itemInsights\"><span data-contrast=\"none\">https:\/\/graph.microsoft.com\/beta\/organization\/{organizationId}\/settings\/itemInsights<\/span><\/a><span data-ccp-props=\"{&quot;134233117&quot;:false,&quot;134233118&quot;:false,&quot;201341983&quot;:0,&quot;335559738&quot;:0,&quot;335559739&quot;:0,&quot;335559740&quot;:240}\">\u00a0<\/span><span data-contrast=\"auto\">which requires the\u202f<\/span><code><span data-contrast=\"auto\">Organization.Read.All<\/span><\/code><span data-contrast=\"auto\"> or <\/span><code><span data-contrast=\"auto\">Organization.ReadWrite.All<\/span><\/code><span data-contrast=\"auto\">\u202fscope.<\/span><span data-ccp-props=\"{&quot;134233117&quot;:false,&quot;134233118&quot;:false,&quot;201341983&quot;:0,&quot;335559738&quot;:0,&quot;335559739&quot;:0,&quot;335559740&quot;:240}\">\u00a0<\/span><\/p>\n<p><b><span data-contrast=\"auto\">Starting January 2024<\/span><\/b><span data-contrast=\"auto\">, that will change to the new path: <\/span><a href=\"https:\/\/graph.microsoft.com\/beta\/admin\/people\/itemInsights\"><span data-contrast=\"none\">https:\/\/graph.microsoft.com\/beta\/admin\/people\/itemInsights<\/span><\/a><span data-contrast=\"auto\"> and the scope requirement will also change to\u202f<\/span><code><span data-contrast=\"auto\">PeopleSettings.Read.All<\/span><\/code><span data-contrast=\"auto\">\u202fand<code>\u202f<\/code><\/span><code><span data-contrast=\"auto\">PeopleSettings.ReadWrite.All<\/span><\/code><span data-contrast=\"auto\">.<\/span><span data-ccp-props=\"{&quot;134233117&quot;:false,&quot;134233118&quot;:false,&quot;201341983&quot;:0,&quot;335559738&quot;:0,&quot;335559739&quot;:0,&quot;335559740&quot;:240}\">\u00a0<\/span><\/p>\n<h2><span data-contrast=\"none\">What you need to do to prepare<\/span><span data-ccp-props=\"{&quot;134245418&quot;:true,&quot;134245529&quot;:true,&quot;335559738&quot;:0,&quot;335559739&quot;:0}\">\u00a0<\/span><\/h2>\n<p><span data-contrast=\"auto\">The following is the summary of the changes that will come to pronouns settings in Microsoft Graph:<\/span><span data-ccp-props=\"{&quot;134233117&quot;:false,&quot;134233118&quot;:false,&quot;201341983&quot;:0,&quot;335559738&quot;:0,&quot;335559739&quot;:0,&quot;335559740&quot;:240}\">\u00a0<\/span><\/p>\n<ul>\n<li data-leveltext=\"\uf0b7\" data-font=\"Symbol\" data-listid=\"1\" data-list-defn-props=\"{&quot;335552541&quot;:1,&quot;335559684&quot;:-2,&quot;335559685&quot;:720,&quot;335559991&quot;:360,&quot;469769226&quot;:&quot;Symbol&quot;,&quot;469769242&quot;:[8226],&quot;469777803&quot;:&quot;left&quot;,&quot;469777804&quot;:&quot;\uf0b7&quot;,&quot;469777815&quot;:&quot;multilevel&quot;}\" aria-setsize=\"-1\" data-aria-posinset=\"1\" data-aria-level=\"1\"><span data-contrast=\"auto\">The path would change from\u202f<\/span><code><a href=\"https:\/\/graph.microsoft.com\/beta\/organization\/%7borganizationId%7d\/settings\/itemInsights\"><span data-contrast=\"none\">https:\/\/graph.microsoft.com\/beta\/organization\/{organizationId}\/settings\/itemInsights<\/span><\/a><\/code><span data-contrast=\"auto\">\u202fto\u202f<\/span><code><a href=\"https:\/\/graph.microsoft.com\/beta\/admin\/people\/itemInsights\"><span data-contrast=\"none\">https:\/\/graph.microsoft.com\/beta\/admin\/people\/itemInsights<\/span><\/a><\/code><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:0,&quot;335559740&quot;:240}\">\u00a0<\/span><\/li>\n<li data-leveltext=\"\uf0b7\" data-font=\"Symbol\" data-listid=\"1\" data-list-defn-props=\"{&quot;335552541&quot;:1,&quot;335559684&quot;:-2,&quot;335559685&quot;:720,&quot;335559991&quot;:360,&quot;469769226&quot;:&quot;Symbol&quot;,&quot;469769242&quot;:[8226],&quot;469777803&quot;:&quot;left&quot;,&quot;469777804&quot;:&quot;\uf0b7&quot;,&quot;469777815&quot;:&quot;multilevel&quot;}\" aria-setsize=\"-1\" data-aria-posinset=\"2\" data-aria-level=\"1\"><span data-contrast=\"auto\">The scope required for reading the item insights settings would change from\u202f\u201c<\/span><code><span data-contrast=\"auto\">Organization.Read.All<\/span><\/code><span data-contrast=\"auto\">\u201d to \u201c<\/span><code><span data-contrast=\"auto\">PeopleSettings.Read.All<\/span><\/code><span data-contrast=\"auto\">\u201d<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:0,&quot;335559740&quot;:240}\">\u00a0<\/span><\/li>\n<li data-leveltext=\"\uf0b7\" data-font=\"Symbol\" data-listid=\"1\" data-list-defn-props=\"{&quot;335552541&quot;:1,&quot;335559684&quot;:-2,&quot;335559685&quot;:720,&quot;335559991&quot;:360,&quot;469769226&quot;:&quot;Symbol&quot;,&quot;469769242&quot;:[8226],&quot;469777803&quot;:&quot;left&quot;,&quot;469777804&quot;:&quot;\uf0b7&quot;,&quot;469777815&quot;:&quot;multilevel&quot;}\" aria-setsize=\"-1\" data-aria-posinset=\"3\" data-aria-level=\"1\"><span data-contrast=\"auto\">The scope required for updating the item insights settings would change from \u201c<\/span><code><span data-contrast=\"auto\">Organization.ReadWrite.All<\/span><\/code><span data-contrast=\"auto\">\u201d to \u201c<\/span><code><span data-contrast=\"auto\">PeopleSettings.ReadWrite.All<\/span><\/code><span data-contrast=\"auto\">\u201d<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:0,&quot;335559740&quot;:240}\">\u00a0<\/span><\/li>\n<li data-leveltext=\"\uf0b7\" data-font=\"Symbol\" data-listid=\"1\" data-list-defn-props=\"{&quot;335552541&quot;:1,&quot;335559684&quot;:-2,&quot;335559685&quot;:720,&quot;335559991&quot;:360,&quot;469769226&quot;:&quot;Symbol&quot;,&quot;469769242&quot;:[8226],&quot;469777803&quot;:&quot;left&quot;,&quot;469777804&quot;:&quot;\uf0b7&quot;,&quot;469777815&quot;:&quot;multilevel&quot;}\" aria-setsize=\"-1\" data-aria-posinset=\"4\" data-aria-level=\"1\"><span data-contrast=\"auto\">The requirement for Global Administrator role would stay the same.<\/span><\/li>\n<\/ul>\n<p>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.<span style=\"font-size: 1rem; text-align: var(--bs-body-text-align);\" data-ccp-props=\"{&quot;134233117&quot;:false,&quot;134233118&quot;:false,&quot;201341983&quot;:0,&quot;335559738&quot;:0,&quot;335559739&quot;:0,&quot;335559740&quot;:240}\">\u00a0<\/span><\/p>\n<h2 aria-level=\"2\"><span data-contrast=\"none\">Resources<\/span><span data-ccp-props=\"{&quot;134245418&quot;:true,&quot;134245529&quot;:true,&quot;335559738&quot;:0,&quot;335559739&quot;:0}\">\u00a0<\/span><\/h2>\n<ul>\n<li><a href=\"https:\/\/learn.microsoft.com\/en-us\/graph\/insights-customize-item-insights-privacy\"><span data-contrast=\"none\">Customize item insights privacy in Microsoft Graph (preview)<\/span><\/a><span data-ccp-props=\"{&quot;134233117&quot;:false,&quot;134233118&quot;:false,&quot;201341983&quot;:0,&quot;335559738&quot;:0,&quot;335559739&quot;:0,&quot;335559740&quot;:240}\">\u00a0<\/span><\/li>\n<li>Follow <a href=\"http:\/\/twitter.com\/microsoft365dev\">@Microsoft365Dev \/ X (Twitter)<\/a> for the latest news and announcements<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"<p>We&#8217;re announcing an upcoming breaking change for admins and developers using Microsoft Graph to control item insights settings in a tenant.\u00a0<\/p>\n","protected":false},"author":135267,"featured_media":16292,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[3],"tags":[277],"class_list":["post-16285","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-microsoft-graph","tag-item-insights-settings"],"acf":[],"blog_post_summary":"<p>We&#8217;re announcing an upcoming breaking change for admins and developers using Microsoft Graph to control item insights settings in a tenant.\u00a0<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts\/16285","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/users\/135267"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/comments?post=16285"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts\/16285\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/media\/16292"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/media?parent=16285"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/categories?post=16285"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/tags?post=16285"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}