---
title: "POST /v2/domains/{domainIdentifier}/glossaries"
method: POST
path: "/v2/domains/{domainIdentifier}/glossaries"
---

# POST /v2/domains/{domainIdentifier}/glossaries

`POST /v2/domains/{domainIdentifier}/glossaries`

Creates an Amazon DataZone business glossary.

Specifies that this is a create glossary policy.

A glossary serves as the central repository for business terminology and definitions within an organization. It helps establish and maintain a common language across different departments and teams, reducing miscommunication and ensuring consistent interpretation of business concepts. Glossaries can include hierarchical relationships between terms, cross-references, and links to actual data assets, making them invaluable for both business users and technical teams trying to understand and use data correctly.

Prerequisites:

*   Domain must exist and be in an active state.
    
*   Owning project must exist and be accessible by the caller.
    
*   The glossary name must be unique within the domain.

## Path parameters

- `domainIdentifier` string, required

## Request body

- object
  - `name` string, password, required — The name of this business glossary.
  - `owningProjectIdentifier` string, required — The ID of the project that currently owns business glossary.
  - `description` string, password — The description of this business glossary.
  - `status` 'DISABLED' | 'ENABLED' — The status of this business glossary.
  - `usageRestrictions` GlossaryUsageRestriction[] — The usage restriction of the restricted glossary.
  - `clientToken` string — A unique, case-sensitive identifier that is provided to ensure the idempotency of the request.

## Response `201`

Success

- CreateGlossaryOutput
  - `domainId` string, required — The ID of the Amazon DataZone domain in which this business glossary is created.
  - `id` string, required — The ID of this business glossary.
  - `name` string, password, required — The name of this business glossary.
  - `owningProjectId` string, required — The ID of the project that currently owns this business glossary.
  - `description` string, password — The description of this business glossary.
  - `status` 'DISABLED' | 'ENABLED' — The status of this business glossary.
  - `usageRestrictions` GlossaryUsageRestriction[] — The usage restriction of the restricted glossary.

## Other responses

- `480` — InternalServerException
- `481` — AccessDeniedException
- `482` — ThrottlingException
- `483` — ServiceQuotaExceededException
- `484` — ConflictException
- `485` — ValidationException
- `486` — UnauthorizedException

---

[API](https://skmtc.net/aws/apis/datazone.md) · [All operations](https://skmtc.net/aws/apis/datazone/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/datazone/versions/055599054b53/schema)