groupSetting resource type

Group settings control behaviors such as blocked word lists for group display names or whether guest users are allowed to be group owners.

Group settings can be created based on the available groupSettingTemplates, and changed from their preset defaults. These settings govern group behaviors at a tenant-wide level or to a specific group. When the same setting is defined at both the tenant-wide and to a specific group, the group-level setting overrides the tenant-wide setting. For example, the tenant-wide setting may allow guests to be invited by existing members of groups, but an individual group setting can override and not allow guests to be invited by members of the group. Group settings only govern Office 365 groups behavior.

Methods

Method Return Type Description
Create setting groupSetting Create a setting object based on a groupSettingTemplate. The POST request must provide settingValues for all the settings defined in the template.
Get setting groupSetting Read properties of a specific setting object.
List settings groupSetting collection List properties of all setting objects.
Update setting groupSetting Update groupsetting object.
Delete setting None Delete a setting object.

Properties

Property Type Description
displayName String Display name of this group of settings, which comes from the associated template.
id String Unique identifier for these settings. Read-only.
templateId String Unique identifier for the template used to create this group of settings. Read-only.
values settingValue collection Collection of name value pairs. Must contain and set all the settings defined in the template.

Relationships

None.

JSON representation

Here is a JSON representation of the resource.

{
  "displayName": "String",
  "id": "String (identifier)",
  "templateId": "String",
  "values": [{"@odata.type": "microsoft.graph.settingValue"}]
}