---
title: "POST /providers/Microsoft.BotService/checkNameAvailability"
method: POST
path: "/providers/Microsoft.BotService/checkNameAvailability"
tags: ["Bot"]
---

# POST /providers/Microsoft.BotService/checkNameAvailability

`POST /providers/Microsoft.BotService/checkNameAvailability`

Check whether a bot name is available.

## Query parameters

- `api-version` string, required

## Request body

- CheckNameAvailabilityRequestBody — The request body for a request to Bot Service Management to check availability of a bot name.
  - `name` string — the name of the bot for which availability needs to be checked.
  - `type` string — the type of the bot for which availability needs to be checked

## Response `200`

The resource provider should return 200 (OK) to indicate that the operation completed successfully. For other errors (e.g. internal errors) use the appropriate HTTP error code.
The nextLink field is expected to point to the URL the client should use to fetch the next page (per server side paging). This matches the OData guidelines for paged responses. If a resource provider does not support paging, it should return the same body but leave nextLink empty for future compatibility.
For a detailed explanation of each field in the response body, please refer to the request body description in the PUT resource section.

- CheckNameAvailabilityResponseBody — The response body returned for a request to Bot Service Management to check availability of a bot name.
  - `valid` boolean — indicates if the bot name is valid.
  - `message` string — additional message from the bot management api showing why a bot name is not available

## Other responses

- `default` — Error response describing why the operation failed

## Changes

- **2018-08-31** (2018-07-12) `c40a78fc7a16` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/azure/apis/azure-bot-service/changes/providers/Microsoft.BotService/checkNameAvailability/post.md)

---

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