---
title: "Create Term"
method: POST
path: "/api/glossary/v2/terms"
tags: ["Terms"]
---

# Create Term

`POST /api/glossary/v2/terms`

Use this API to create a new term in the Glossary.

## Request body

- DataUseGovernanceDataCatalogTermCreateRequestV2
  - `name` string, required — Name of the term
  - `type` 'Data Element' | 'Business Term' | 'Acronym' | 'Key Performance Indicator' | 'Metric' | 'Type of Individual', required — Type of the term
  - `glossaryName` string, required — Valid glossary name
  - `createAsApproved` boolean — Create a term as approved
  - `shortDescription` string — Short description about term
  - `example` string — Example Value for the term
  - `notes` string — Notes for the term
  - `technicalOwner` DataUseGovernanceDataCatalogUserAndGroupNames
    - `userEmails` string[]
    - `groupNames` string[]
  - `businessOwner` DataUseGovernanceDataCatalogUserAndGroupNames
    - `userEmails` string[]
    - `groupNames` string[]
  - `dataSteward` DataUseGovernanceDataCatalogUserAndGroupNames
    - `userEmails` string[]
    - `groupNames` string[]
  - `tags` string[]
  - `customAttributes` DataUseGovernanceDataCatalogCustomAttributes[]
    - `name` string — Name of the custom attribute
    - `value` string — Value of the custom attribute
    - `options` string[]

## Response `201`

Created

- DataUseGovernanceDataCatalogTermResponse
  - `id` string, uuid — Unique identifier
  - `name` string — Name of the entity
  - `nameKey` string — Key used for name localization
  - `type` string — Type of the term
  - `typeKey` string — Key used for type localization
  - `shortDescription` string — Brief description of the term
  - `glossary` DataUseGovernanceDataCatalogIdValueKeyDto
    - `id` string, uuid — Unique identifier
    - `value` string — Display value
    - `key` string — Key used for localization
  - `numericId` integer — Numeric identifier for the term
  - `example` string — Example usage of the term
  - `businessOwner` string[]
  - `technicalOwner` string[]
  - `dataSteward` string[]
  - `notes` string — Additional notes about the term
  - `source` string — Source of the term
  - `createdDate` string, date-time — Creation timestamp
  - `lastUpdatedDate` string, date-time — Last update timestamp
  - `createdBy` string, uuid — UUID of the user who created the term
  - `lastUpdatedBy` string, uuid — UUID of the user who last updated the term
  - `status` string — Current status of the term
  - `associatedTags` string[]
  - `tags` DataUseGovernanceDataCatalogTagResponse[]
    - `id` string, uuid — UUID of the tag
    - `tagId` integer — Numeric identifier for the tag
    - `name` string — Name of the tag
    - `description` string — Description of the tag
    - `type` string — Type of the tag
    - `createdBy` string, uuid — UUID of the user who created the tag
    - `createdDate` string, date-time — Tag creation timestamp
    - `updatedBy` string, uuid — UUID of the user who updated the tag
    - `updatedDate` string, date-time — Tag update timestamp
    - `athenaId` string, uuid — Athena Id for the tag

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `429` — Too Many Requests. For more information, see [API Rate Limits](https://developer.onetrust.com/onetrust/reference/rate-limits-overview).
- `500` — Internal Server Error

---

[API](https://skmtc.net/onetrust/apis/platform-access-management.md) · [All operations](https://skmtc.net/onetrust/apis/platform-access-management/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/onetrust/platform-access-management/versions/21de3aa0b170/schema)