groupsetting-delete.md

title	Delete a group setting
description	Delete a group setting.
author	yuhko-msft
ms.reviewer	mbhargav, khotzteam, aadgroupssg
ms.localizationpriority	medium
ms.subservice	entra-groups
doc_type	apiPageType
ms.date	03/06/2024

Delete a group setting

Namespace: microsoft.graph

Delete a tenant-level or group-specific groupSetting object.

[!INCLUDE national-cloud-support]

Permissions

The following tables show the least privileged permission or permissions required to call this API on each supported resource type. Follow best practices to request least privileged permissions. For details about delegated and application permissions, see Permission types. To learn more about these permissions, see the permissions reference.

For tenant-wide settings

[!INCLUDE permissions-table]

[!INCLUDE rbac-group-directorysettings-all]

For group-specific settings

[!INCLUDE permissions-table]

HTTP request

Delete a tenant-wide setting.

DELETE /groupSettings/{groupSettingId}

Delete a group-specific setting.

DELETE /groups/{groupId}/settings/{groupSettingId}

Request headers

Name	Description
Authorization	Bearer {token}. Required. Learn more about authentication and authorization.
Content-Type	application/json

Request body

Don't supply a request body for this method.

Response

If successful, this method returns 204 No Content response code. It doesn't return anything in the response body.

Example

Request

In this example, you delete the tenant-level group setting object.

HTTP

DELETE https://graph.microsoft.com/v1.0/groupSettings/{id}

C#

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

Go

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

Java

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

JavaScript

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

PHP

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

Python

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

---

Response

HTTP/1.1 204 No Content