---
title: "POST /providers/Microsoft.Management/checkNameAvailability"
method: POST
path: "/providers/Microsoft.Management/checkNameAvailability"
tags: ["CheckNameAvailability"]
---

# POST /providers/Microsoft.Management/checkNameAvailability

`POST /providers/Microsoft.Management/checkNameAvailability`

Checks if the specified management group or service group name is valid and unique

## Query parameters

- `api-version` string, required

## Request body

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

## Response `200`

OK. The request has succeeded.

- CheckNameAvailabilityResult — Describes the result of the request to check management group name or service 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` — Error response describing why the operation failed.

---

[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/versions/8a88b7130da6/schema)