# Create

Launch stage: GA

`POST /api/2.1/unity-catalog/entity-tag-assignments`

Creates a tag assignment for an Unity Catalog entity.

 To add tags to Unity Catalog entities, you must own the entity or have the following privileges:
 - **APPLY TAG** on the entity
 - **USE SCHEMA** on the entity's parent schema
 - **USE CATALOG** on the entity's parent catalog

 To add a governed tag to Unity Catalog entities, you must also have the **ASSIGN** or **MANAGE** permission on the tag policy. See [Manage tag policy permissions](https://docs.databricks.com/aws/en/admin/tag-policies/manage-permissions).

API scopes: unity-catalog

## Request body

- `tag_assignment` (object, optional)
  - `entity_name` (string, optional)
    The fully qualified name of the entity to which the tag is assigned
  - `tag_key` (string, optional)
    The key of the tag
  - `tag_value` (string, optional)
    The value of the tag
  - `entity_type` (string, optional)
    The type of the entity to which the tag is assigned.
  - `update_time` (string, optional)
    The timestamp when the tag assignment was last updated
  - `updated_by` (string, optional)
    The user or principal who updated the tag assignment
  - `source_type` (string, optional)
    The source type of the tag assignment, e.g., user-assigned or system-assigned
    Possible values: `TAG_ASSIGNMENT_SOURCE_TYPE_UNSPECIFIED`, `TAG_ASSIGNMENT_SOURCE_TYPE_SYSTEM_DATA_CLASSIFICATION`

## Returns

Returns the EntityTagAssignment object.

## Request

```json
{
  "entity_name": "main.default.customer_data",
  "entity_type": "tables",
  "tag_key": "Severity",
  "tag_value": "high"
}
```

## Response

```json
{
  "entity_name": "main.default.customer_data",
  "entity_type": "tables",
  "source_type": "TAG_ASSIGNMENT_SOURCE_TYPE_UNSPECIFIED",
  "tag_key": "Severity",
  "tag_value": "high",
  "update_time": "2026-01-15T10:30:00.000Z",
  "updated_by": "user@example.com"
}
```