userSettings resource type

Namespace: microsoft.graph

Important

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.

Settings that represent a user’s preferences for regional locale and languages, for shift scheduling, for Delve and for item insights.

Manage user's locale-based preferences:

  • Determining what language and regional formatting a user prefers to view applications with.
  • Updating a user's language and regional formatting preferences.

Manage user's work shift preferences:

  • Checking whether a user can be assigned to shifts in a schedule.
  • Updating a user's shift preferences.

Manage Delve accessibility:

  • Checking whether a user and the user's organization have access to Office Delve.
  • Disabling or enabling documents in Office Delve for specific users.

Configure the visibility of itemInsights and meeting hours insights. ItemInsights are derived between users and other items (such as documents or sites) in Microsoft 365:

  • Checking whether a user's item and meeting hours insights are enabled.
  • Disabling or enabling item and meeting hours insights for specific user.

To learn how to get or update user settings, see Get settings and Update settings.

Note

This endpoint works only with users. You can't use this endpoint with contacts.

Methods

Method Return Type Description
Get user settings userSettings Get the user and organization settings.
Update user settings userSettings Update the user current settings.

Properties

Property Type Description
contributionToContentDiscoveryDisabled Boolean When set to true, documents in the user's Office Delve are disabled. Users can control this setting in Office Delve.
contributionToContentDiscoveryAsOrganizationDisabled Boolean Reflects the Office Delve organization level setting. When set to true, the organization doesn't have access to Office Delve. This setting is read-only and can only be changed by administrators in the SharePoint admin center.

Relationships

Relationship Type Description
shiftPreferences shiftPreferences The shift preferences for the user.
regionalAndLanguageSettings regionalAndLanguageSettings The user's preferences for languages, regional locale and date/time formatting.
itemInsights userInsightsSettings The user's settings for the visibility of meeting hour insights, and insights derived between a user and other items in Microsoft 365, such as documents or sites. Get userInsightsSettings through this navigation property.

JSON representation

Here is a JSON representation of the resource.

{
  "contributionToContentDiscoveryDisabled": false,
  "contributionToContentDiscoveryAsOrganizationDisabled": false
}