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

# Create Term

`POST /api/glossary/v2/terms`

## Request

- Base URL: `https://hostname`
- URL: `https://hostname/api/glossary/v2/terms`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://{hostname}/api/access/v1/oauth/token` scopes: `DATA_CATALOG_WRITE`

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.dev/onetrust/apis/data-use-governance-data-catalog.md) - [All operations](https://skmtc.dev/onetrust/apis/data-use-governance-data-catalog/llms.txt) - [OpenAPI document](https://skmtc.dev/onetrust/apis/data-use-governance-data-catalog/revisions/df847e469733?raw)