# Update

Launch stage: Beta

`PATCH /api/2.0/entity-tag-assignments/{tag_assignment.entity_type}/{tag_assignment.entity_id}/tags/{tag_assignment.tag_key}`

Update a tag assignment

API scopes: tags

## Path parameters

- `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`

## Query parameters

- `update_mask` (string, optional)

## Returns

Returns the TagAssignment object.

## Request

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

## Response

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