> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getcollate.io/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](/api-reference/governance/domains/create) |
| `POST` | `/v1/domains` | [Create a domain (POST variant)](/api-reference/governance/domains/create) |
| `GET` | `/v1/domains` | [List domains](/api-reference/governance/domains/list) |
| `GET` | `/v1/domains/{id}` | [Get by ID](/api-reference/governance/domains/retrieve) |
| `GET` | `/v1/domains/name/{fqn}` | [Get by FQN](/api-reference/governance/domains/retrieve) |
| `PATCH` | `/v1/domains/{id}` | [Update by ID](/api-reference/governance/domains/update) |
| `PATCH` | `/v1/domains/name/{fqn}` | [Update by name](/api-reference/governance/domains/update) |
| `DELETE` | `/v1/domains/{id}` | [Delete by ID](/api-reference/governance/domains/delete) |
| `DELETE` | `/v1/domains/name/{fqn}` | [Delete by name](/api-reference/governance/domains/delete) |
| `PUT` | `/v1/domains/restore` | [Restore soft-deleted domain](/api-reference/governance/domains/delete) |
| `GET` | `/v1/domains/{id}/versions` | [List versions](/api-reference/governance/domains/versions) |
| `GET` | `/v1/domains/{id}/versions/{version}` | [Get specific version](/api-reference/governance/domains/versions) |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.