---
title: "POST /providers/Microsoft.Management/checkNameAvailability"
method: POST
path: "/providers/Microsoft.Management/checkNameAvailability"
---

# POST /providers/Microsoft.Management/checkNameAvailability

`POST /providers/Microsoft.Management/checkNameAvailability`

Checks if the specified management group name is valid and unique

## Parameters

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

## Request body

- CheckNameAvailabilityRequest — Management group name availability check parameters.
  - `name` string — the name to check for availability
  - `type` 'Microsoft.Management/managementGroups' — fully qualified resource type which includes provider namespace

## Response `200`

The request has succeeded.

- CheckNameAvailabilityResult — Describes the result of the request to check management group name availability.
  - `nameAvailable` boolean — Required. True indicates name is valid and available. False indicates the name is invalid, unavailable, or both.
  - `reason` 'Invalid' | 'AlreadyExists' — Required if nameAvailable == false. Invalid indicates the name provided does not match the resource provider's naming requirements (incorrect length, unsupported characters, etc.) AlreadyExists indicates that the name is already in use and is therefore unavailable.
  - `message` string — Required if nameAvailable == false. Localized. If reason == invalid, provide the user with the reason why the given name is invalid, and provide the resource naming requirements so that the user can select a valid name. If reason == AlreadyExists, explain that is already in use, and direct them to select a different name.

## 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)