---
title: "POST /v1/{+parent}/glossaries"
method: POST
path: "/v1/{+parent}/glossaries"
tags: ["projects"]
---

# POST /v1/{+parent}/glossaries

`POST /v1/{+parent}/glossaries`

Creates a new Glossary resource.

## Path parameters

- `parent` string, required

## Query parameters

- `glossaryId` string
- `validateOnly` boolean

## Request body

- GoogleCloudDataplexV1Glossary — A Glossary represents a collection of GlossaryCategories and GlossaryTerms defined by the user. Glossary is a top level resource and is the Google Cloud parent resource of all the GlossaryCategories and GlossaryTerms within it.
  - `updateTime` string, google-datetime — Output only. The time at which the Glossary was last updated.
  - `createTime` string, google-datetime — Output only. The time at which the Glossary was created.
  - `uid` string — Output only. System generated unique id for the Glossary. This ID will be different if the Glossary is deleted and re-created with the same name.
  - `categoryCount` integer — Output only. The number of GlossaryCategories in the Glossary.
  - `name` string — Output only. Identifier. The resource name of the Glossary. Format: projects/{project_id_or_number}/locations/{location_id}/glossaries/{glossary_id}
  - `etag` string — Optional. Needed for resource freshness validation. This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding.
  - `description` string — Optional. The user-mutable description of the Glossary.
  - `displayName` string — Optional. User friendly display name of the Glossary. This is user-mutable. This will be same as the GlossaryId, if not specified.
  - `termCount` integer — Output only. The number of GlossaryTerms in the Glossary.
  - `labels` object — Optional. User-defined labels for the Glossary.

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/dataplex.md) · [All operations](https://skmtc.net/google/apis/dataplex/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/dataplex/versions/43a3b60ca93b/schema)