directorySettingTemplate 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.

Directory setting templates represent system-defined settings available to the tenant. Directory settings can be created based on the available directorySettingTemplates, and values changed from their preset defaults. Directory setting templates can't be created, updated, or deleted. These settings can represent tenant-wide settings, or can represent specific entity settings. Currently, the only templates available for groups apply to Microsoft 365 groups, and include settings such as whether users can create groups or invite guests from outside the organization to become members of a group.

For more information about the Microsoft 365 groups-specific settings, see group (directory) settings.

Tip

The /v1.0 version of this resource is named groupSettingTemplate.

Methods

Method	Return Type	Description
Get	directorySettingTemplate	Read the specific properties of one of the system defined directorySettingTemplate objects.
List	Collection of directorySettingTemplate	List all of the system defined directorySettingTemplate objects.

Properties

Property	Type	Description
description	string	Description of the template. Read-only.
displayName	string	Display name of the template. Read-only.
id	string	Unique identifier for the template. Read-only.
values	settingTemplateValue collection	Collection of settingTemplateValues that list the set of available settings, defaults, and types that make up this template. Read-only.

Relationships

None

JSON representation

The following JSON representation shows the resource type.

{
  "description": "string",
  "displayName": "string",
  "id": "string (identifier)",
  "values": [{"@odata.type": "microsoft.graph.settingTemplateValue"}]
}