insightsSettings resource type

Namespace: microsoft.graph

Represents settings to calculate and manage the display or programmatic return of a specific type of insights in an organization.

Item insights and meeting hours insights represent relationships between users and items such as documents, sites, and other content types in Microsoft 365. Programmatically, they're represented by the itemInsights resource. You can get documents that are shared with a user, trending around a user, or used by a user. You can use insightsSettings to customize the privacy settings for calculating, displaying, or returning item insights in an organization.

In contrast, for item insights and meeting hours insights, you can also manage their calculation and visibility at a user level by using the userInsightsSettings resource.

Methods

Method	Return Type	Description
List itemInsights	insightsSettings	Get the properties of an insightsSettings object to display or return item insights in an organization.
Update insightsSettings	insightsSettings	Update privacy settings to display or return the specified type of insights in an organization. Currently, itemInsights is the only supported type of settings.

Properties

Property	Type	Description
disabledForGroup	String	The ID of a Microsoft Entra group, of which the specified type of insights are disabled for its members. The default value is null. Optional.
isEnabledInOrganization	Boolean	true if insights of the specified type are enabled for the organization; false if insights of the specified type are disabled for all users without exceptions. The default value is true. Optional.

JSON representation

The following JSON representation shows the resource type.

{
  "disabledForGroup": "String",
  "isEnabledInOrganization": "Boolean"
}