---
title: "POST /subscriptions/{subscriptionId}/providers/Microsoft.PowerBI/locations/{location}/checkNameAvailability"
method: POST
path: "/subscriptions/{subscriptionId}/providers/Microsoft.PowerBI/locations/{location}/checkNameAvailability"
tags: ["WorkspaceCollections"]
---

# POST /subscriptions/{subscriptionId}/providers/Microsoft.PowerBI/locations/{location}/checkNameAvailability

`POST /subscriptions/{subscriptionId}/providers/Microsoft.PowerBI/locations/{location}/checkNameAvailability`

## Request

- Base URL: `https://management.azure.com`
- URL: `https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.PowerBI/locations/{location}/checkNameAvailability`
- Auth: none declared

Verify the specified Power BI Workspace Collection name is valid and not already in use.

## Path parameters

- `subscriptionId` string, required
- `location` string, required

## Query parameters

- `api-version` string, required

## Request body

- CheckNameRequest
  - `name` string: Workspace collection name
  - `type` string: Resource type

## Response `200`

Request completed successfully

- CheckNameResponse
  - `nameAvailable` boolean: Specifies a Boolean value that indicates whether the specified Power BI Workspace Collection name is available to use.
  - `reason` 'Unavailable' | 'Invalid': Reason why the workspace collection name cannot be used.
  - `message` string: Message indicating an unavailable name due to a conflict, or a description of the naming rules that are violated.

## Other responses

- `default`: Default Response. It will be deserialized as per the Error definition specified in the schema. Exception will be thrown.

---

[API](https://skmtc.dev/azure/apis/power-bi-embedded-management-client.md) - [All operations](https://skmtc.dev/azure/apis/power-bi-embedded-management-client/llms.txt) - [OpenAPI document](https://skmtc.dev/azure/apis/power-bi-embedded-management-client/revisions/8f5fd893fd71?raw)