> ## 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.

# Glossary Terms

> Create and manage glossary terms within glossaries

# Glossary Terms

A **Glossary Term** is a specific business term defined within a glossary. Terms can be hierarchically nested and support synonyms, related terms, and rich metadata.

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

## Entity Hierarchy

Glossary Terms belong to a Glossary and can be nested:

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

## Fully Qualified Name

The FQN format for a glossary term is:

```
glossary.termName
```

For nested terms:

```
glossary.parent.child
```

For example: `BusinessGlossary.Revenue` or `BusinessGlossary.Revenue.GrossRevenue`

***

## API Endpoints

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