# Create

Launch stage: Beta

`POST /api/2.0/entity-tag-assignments`

Create a tag assignment

API scopes: tags

## Request body

- `tag_assignment` (object, optional)
  - `entity_type` (string, optional)
    The type of entity to which the tag is assigned. Allowed values are apps, dashboards, geniespaces, notebooks
    Example: `dashboards`
  - `entity_id` (string, optional)
    The identifier of the entity to which the tag is assigned. For apps, the entity_id is the app name
    Example: `2807324866692453`
  - `tag_key` (string, optional)
    The key of the tag. The characters , . : / - = and leading/trailing spaces are not allowed
    Example: `sensitivity_level`
    Constraints: `[ 1 .. 256 ] characters`
  - `tag_value` (string, optional)
    The value of the tag
    Example: `high`
    Constraints: `<= 1000 characters`

## Returns

Returns the TagAssignment object.

## Request

```json
{
  "entity_id": "2807324866692453",
  "entity_type": "dashboards",
  "tag_key": "sensitivity_level",
  "tag_value": "high"
}
```

## Response

```json
{
  "entity_id": "2807324866692453",
  "entity_type": "dashboards",
  "tag_key": "sensitivity_level",
  "tag_value": "high"
}
```