itemInsightsSettings resource type


APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.

Represents privacy settings for itemInsights and privacy setting for meeting hours insights . Use this API to disable/enable calculation and visibility of item insights and meeting hours insights. 

  • Item insights: Calculates relationship between users and items such as documents or sites in Microsoft 365.  
  • Meeting hours insights: Calculates a person's calendar meeting hours based on activities in Word, Excel, PowerPoint, email, and Outlook calendar in Microsoft 365.

Use the userInsightsSettings resource to disable/enable calculation and visibility of item insights and meeting hours insights of a user.


Method Return Type Description
Get itemInsightsSettings Read the properties of an itemInsightsSettings object.
Update itemInsightsSettings Update an itemInsightsSettings object.


Property Type Description
isEnabledInOrganization Boolean true if organization item insights are enabled; false if organization item insights are disabled for all users without exceptions. Default is true. Optional.
disabledForGroup String The ID of an Azure AD group, of which the members' item insights are disabled. Default is empty. Optional.

JSON representation

Here is a JSON representation of the resource

  "isEnabledInOrganization": "Boolean",
  "disabledForGroup": "String"