# Create

Launch stage: GA

`PUT /api/2.1/unity-catalog/workspaces/{workspace_id}/metastore`

Creates a new metastore assignment.
 If an assignment for the same __workspace_id__ exists, it will be overwritten by the new __metastore_id__ and
 __default_catalog_name__. The caller must be an account admin.

API scopes: unity-catalog

## Path parameters

- `workspace_id` (int64, optional)
  A workspace ID.

## Request body

- `metastore_id` (string, optional)
  The unique ID of the metastore.
- `default_catalog_name` (string, optional)
  The name of the default catalog in the metastore.
   This field is deprecated. Please use "Default Namespace API" to
   configure the default catalog for a <Databricks> workspace.

## Response

```json
{}
```