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

# Glossaries

> Create and manage glossaries for business terminology

# Glossaries

A **Glossary** is a collection of business terms and definitions that provides a shared vocabulary across an organization. Glossaries help ensure consistent understanding of business concepts and data semantics.

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

## Fully Qualified Name

The FQN format for a glossary is:

```
glossaryName
```

For example: `BusinessGlossary`

***

## API Endpoints

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