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

# POST /v1/{+parent}/categories

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

Creates a new GlossaryCategory resource.

## Path parameters

- `parent` string, required

## Query parameters

- `categoryId` string

## Request body

- GoogleCloudDataplexV1GlossaryCategory — A GlossaryCategory represents a collection of GlossaryCategories and GlossaryTerms within a Glossary that are related to each other.
  - `createTime` string, google-datetime — Output only. The time at which the GlossaryCategory was created.
  - `updateTime` string, google-datetime — Output only. The time at which the GlossaryCategory was last updated.
  - `description` string — Optional. The user-mutable description of the GlossaryCategory.
  - `name` string — Output only. Identifier. The resource name of the GlossaryCategory. Format: projects/{project_id_or_number}/locations/{location_id}/glossaries/{glossary_id}/categories/{category_id}
  - `parent` string — Required. The immediate parent of the GlossaryCategory in the resource-hierarchy. It can either be a Glossary or a GlossaryCategory. Format: projects/{project_id_or_number}/locations/{location_id}/glossaries/{glossary_id} OR projects/{project_id_or_number}/locations/{location_id}/glossaries/{glossary_id}/categories/{category_id}
  - `uid` string — Output only. System generated unique id for the GlossaryCategory. This ID will be different if the GlossaryCategory is deleted and re-created with the same name.
  - `displayName` string — Optional. User friendly display name of the GlossaryCategory. This is user-mutable. This will be same as the GlossaryCategoryId, if not specified.
  - `labels` object — Optional. User-defined labels for the GlossaryCategory.

## Response `200`

Successful response

---

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