> ## Documentation Index
> Fetch the complete documentation index at: https://docs.open-metadata.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Tags

> Create and manage tags within classifications

# Tags

A **Tag** is a label within a classification that can be applied to data assets for categorization and governance. Tags can be hierarchically nested within a classification.

<Info>
  Entity schema follows the [OpenMetadata Standard](https://openmetadatastandards.org/governance/tag/).
</Info>

## Entity Hierarchy

Tags belong to a Classification and can be nested:

<CodeGroup>
  ```txt Tag theme={null}
  Classification
  ├── Tag (top-level)
  │   ├── Tag (child)
  │   └── Tag (child)
  └── Tag (top-level)
  ```
</CodeGroup>

## Fully Qualified Name

The FQN format for a tag is:

```
classification.tagName
```

For nested tags:

```
classification.parent.child
```

For example: `Certification.Bronze` or `PII.Sensitive.SSN`

***

## API Endpoints

| Method   | Endpoint                           | Description                                                                  |
| -------- | ---------------------------------- | ---------------------------------------------------------------------------- |
| `PUT`    | `/v1/tags`                         | [Create or update a tag](/v1.12.x/api-reference/governance/tags/create)      |
| `POST`   | `/v1/tags`                         | [Create a tag (POST variant)](/v1.12.x/api-reference/governance/tags/create) |
| `GET`    | `/v1/tags`                         | [List tags](/v1.12.x/api-reference/governance/tags/list)                     |
| `GET`    | `/v1/tags/{id}`                    | [Get by ID](/v1.12.x/api-reference/governance/tags/retrieve)                 |
| `GET`    | `/v1/tags/name/{fqn}`              | [Get by FQN](/v1.12.x/api-reference/governance/tags/retrieve)                |
| `PATCH`  | `/v1/tags/{id}`                    | [Update by ID](/v1.12.x/api-reference/governance/tags/update)                |
| `PATCH`  | `/v1/tags/name/{fqn}`              | [Update by name](/v1.12.x/api-reference/governance/tags/update)              |
| `DELETE` | `/v1/tags/{id}`                    | [Delete by ID](/v1.12.x/api-reference/governance/tags/delete)                |
| `DELETE` | `/v1/tags/name/{fqn}`              | [Delete by name](/v1.12.x/api-reference/governance/tags/delete)              |
| `PUT`    | `/v1/tags/restore`                 | [Restore soft-deleted tag](/v1.12.x/api-reference/governance/tags/delete)    |
| `GET`    | `/v1/tags/{id}/versions`           | [List versions](/v1.12.x/api-reference/governance/tags/versions)             |
| `GET`    | `/v1/tags/{id}/versions/{version}` | [Get specific version](/v1.12.x/api-reference/governance/tags/versions)      |