---
title: "POST /subscriptions/{subscriptionId}/providers/Microsoft.DevOpsInfrastructure/checkNameAvailability"
method: POST
path: "/subscriptions/{subscriptionId}/providers/Microsoft.DevOpsInfrastructure/checkNameAvailability"
tags: ["Pools"]
---

# POST /subscriptions/{subscriptionId}/providers/Microsoft.DevOpsInfrastructure/checkNameAvailability

`POST /subscriptions/{subscriptionId}/providers/Microsoft.DevOpsInfrastructure/checkNameAvailability`

Checks that the pool name is valid and is not already in use.

## Parameters

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

## Request body

- CheckNameAvailability — The parameters used to check the availability of a resource.
  - `name` string, required — The name of the resource.
  - `type` 'Microsoft.DevOpsInfrastructure/pools', required — The type of resource.

## Response `200`

The request has succeeded.

- CheckNameAvailabilityResult — The CheckNameAvailability operation response.
  - `available` 'Available' | 'Unavailable', required — AvailabilityStatus of a name.
  - `message` string, required — A message explaining why the name is unavailable. Will be null if the name is available.
  - `name` string, required — The name whose availability was checked.
  - `reason` 'Invalid' | 'AlreadyExists', required — The reason code explaining why the name is unavailable. Will be null if the name is available.

## Other responses

- `default` — An unexpected error response.

## Changes

- **2026-07-13** (2023-10-30-preview) `ade15aadc05e` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/azure/apis/devopsinfrastructure-microsoft-devopsinfrastructure-devopsin/changes/subscriptions/:subscriptionId/providers/Microsoft.DevOpsInfrastructure/checkNameAvailability/post.md)

---

[API](https://skmtc.dev/azure/apis/devopsinfrastructure-microsoft-devopsinfrastructure-devopsin.md) · [All operations](https://skmtc.dev/azure/apis/devopsinfrastructure-microsoft-devopsinfrastructure-devopsin/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/devopsinfrastructure-microsoft-devopsinfrastructure-devopsin/revisions/850606f7ff15/schema)