---
title: "PATCH /providers/Microsoft.Management/managementGroups/{groupId}/settings/default"
method: PATCH
path: "/providers/Microsoft.Management/managementGroups/{groupId}/settings/default"
tags: ["HierarchySettingsOperationGroup"]
---

# PATCH /providers/Microsoft.Management/managementGroups/{groupId}/settings/default

`PATCH /providers/Microsoft.Management/managementGroups/{groupId}/settings/default`

Updates the hierarchy settings defined at the Management Group level.

## Path parameters

- `groupId` string, required

## Parameters

- `../../../../../../common-types/resource-management/v3/types.json#/components/parameters/ApiVersionParameter` — unresolved $ref

## Request body

- CreateOrUpdateSettingsRequest — Parameters for creating or updating Management Group settings
  - `properties` CreateOrUpdateSettingsProperties — The properties of the request to create or update Management Group settings
    - `requireAuthorizationForGroupCreation` boolean — Indicates whether RBAC access is required upon group creation under the root Management Group. If set to true, user will require Microsoft.Management/managementGroups/write action on the root Management Group scope in order to create new Groups directly under the root. This will prevent new users from creating new Management Groups, unless they are given access.
    - `defaultManagementGroup` string — Settings that sets the default Management Group under which new subscriptions get added in this tenant. For example, /providers/Microsoft.Management/managementGroups/defaultGroup

## Response `200`

Azure operation completed successfully.

- HierarchySettings — unresolved $ref

## Other responses

- `default` — An unexpected error response.

---

[API](https://skmtc.net/azure/apis/management-microsoft-management-managementgroups.md) · [All operations](https://skmtc.net/azure/apis/management-microsoft-management-managementgroups/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/management-microsoft-management-managementgroups/revisions/2a185afab701/schema)