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 the following:
- Access to Delve
- Item insights
- Regional locale and languages
- Shift scheduling
- Suggestions to merge duplicate contacts
This resource type provides access to the following operations.
Manage Delve accessibility:
- Determine whether a user and the user's organization have access to Office Delve.
- Disable or enable documents in Office Delve for specific users.
Configure the visibility of itemInsights and meeting hours insights. Item insights are derived between users and other items (such as documents or sites) in Microsoft 365:
- Determine whether a user's item and meeting hours insights are enabled.
- Disable or enable item and meeting hours insights for specific user.
Manage user's locale-based preferences:
- Determine what language and regional formatting a user prefers to view applications with.
- Update a user's language and regional formatting preferences.
Manage users' work shift preferences:
- Determine whether a user can be assigned to shifts in a schedule.
- Update a user's shift preferences.
Configure contactMergeSuggestions:
- Determine whether suggestions to merge duplicate contacts for a user is enabled.
- Disable or enable suggestions to merge duplicate contacts for a user.
Export users' Windows settings and values stored in a cloud:
- Get a list of the user's windowsSetting objects.
- Get a filtered list of the user's windowsSetting objects by passing one of the following in the filter query:
Inherits from entity.
Note
This endpoint works only with the user resource.
Methods
| Method | Return Type | Description |
|---|---|---|
| Get settings | userSettings | Get the user and organization settings. |
| Update settings | userSettings | Update the user current settings. |
| List | windowsSetting collection | Get the windowsSetting objects and their properties for the signed in user. |
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. |
| id | String | Unique identifier of the user setting. Read-only. Inherited from entity. |
Relationships
| Relationship | Type | Description |
|---|---|---|
| contactMergeSuggestions | contactMergeSuggestions | The user's settings for the visibility of merge suggestion for the duplicate contacts in the user's contact list. |
| 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. |
| regionalAndLanguageSettings | regionalAndLanguageSettings | The user's preferences for languages, regional locale and date/time formatting. |
| shiftPreferences | shiftPreferences | The shift preferences for the user. |
| windows | windowsSetting collection | The Windows settings of the user stored in the cloud. |
JSON representation
The following JSON representation shows the resource type.
{
"contributionToContentDiscoveryDisabled": false,
"contributionToContentDiscoveryAsOrganizationDisabled": false
}