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

# Domains

> Create and manage domains for organizing data assets by business areas

# Domains

A **Domain** is a bounded context that represents a business area or organizational unit. Domains provide a way to organize and group data assets by business function, enabling decentralized data ownership.

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

## Domain Types

Domains can be one of three types:

| Type               | Description                                                      |
| ------------------ | ---------------------------------------------------------------- |
| `Source-aligned`   | Domains aligned with the source systems that produce data        |
| `Consumer-aligned` | Domains aligned with the teams or applications that consume data |
| `Aggregate`        | Domains that aggregate data from multiple sources                |

## Fully Qualified Name

The FQN format for a domain is:

```
domainName
```

For nested domains:

```
parent.child
```

For example: `Marketing` or `Engineering.DataPlatform`

***

## API Endpoints

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