---
title: "POST /atlas/v2/glossary/terms"
method: POST
path: "/atlas/v2/glossary/terms"
---

# POST /atlas/v2/glossary/terms

`POST /atlas/v2/glossary/terms`

Create glossary terms in bulk.

## Query parameters

- `api-version` string
- `includeTermHierarchy` boolean

## Request body

- AtlasGlossaryTerm[]
  - `guid` string — The GUID of the object.
  - `classifications` AtlasClassification[] — An array of classifications.
    - `attributes` object — The attributes of the struct.
    - `typeName` string — The name of the type.
    - `lastModifiedTS` string — ETag for concurrency control.
    - `entityGuid` string — The GUID of the entity.
    - `entityStatus` 'ACTIVE' | 'DELETED' — Status - can be active or deleted
    - `removePropagationsOnEntityDelete` boolean — Determines if propagations will be removed on entity deletion.
    - `validityPeriods` TimeBoundary[] — An array of time boundaries indicating validity periods.
      - `endTime` string — The end of the time boundary.
      - `startTime` string — The start of the time boundary.
      - `timeZone` string — The timezone of the time boundary.
  - `longDescription` string — The long version description.
  - `name` string — The name of the glossary object.
  - `qualifiedName` string — The qualified name of the glossary object.
  - `shortDescription` string — The short version of description.
  - `lastModifiedTS` string — ETag for concurrency control.
  - `createTime` integer — The created time of the record.
  - `createdBy` string — The user who created the record.
  - `updateTime` integer — The update time of the record.
  - `updatedBy` string — The user who updated the record.
  - `abbreviation` string — The abbreviation of the term.
  - `templateName` unknown[] — The name of the template.
    - unknown
  - `anchor` AtlasGlossaryHeader — The glossary header with basic information.
    - `displayText` string — The display text.
    - `glossaryGuid` string — The GUID of the glossary.
    - `relationGuid` string — The GUID of the relationship.
  - `antonyms` AtlasRelatedTermHeader[] — An array of related term headers as antonyms.
    - `description` string — The description of the related term.
    - `displayText` string — The display text.
    - `expression` string — The expression of the term.
    - `relationGuid` string — The GUID of the relationship.
    - `status` 'DRAFT' | 'ACTIVE' | 'DEPRECATED' | 'OBSOLETE' | 'OTHER' — Status for atlas term relationship
    - `steward` string — The steward of the term.
    - `termGuid` string — The GUID of the term.
  - `status` 'Draft' | 'Approved' | 'Alert' | 'Expired' — Status for term
  - `nickName` string — The nick name of the term.
  - `hierarchyInfo` PurviewObjectId[] — The hierarchy information of the term.
    - `guid` string — The GUID of the object.
    - `typeName` string — The name of the type.
    - `uniqueAttributes` object — The unique attributes of the object.
    - `name` string — Name
    - `displayText` string — Display text
    - `itemPath` string — Item path
    - `resourceId` string — Resource Id
    - `properties` object — Dictionary of <any>
  - `resources` ResourceLink[] — An array of resource link for term
    - `displayName` string — Display name for url.
    - `url` string — web url. http or https
  - `contacts` object — The dictionary of contacts for terms. Key could be Expert or Steward.
  - `attributes` object — The custom attributes of the term, which is map<string,map<string,object>>. The key of the first layer map is term template name.
  - `assignedEntities` AtlasRelatedObjectId[] — An array of related object IDs.
    - `guid` string — The GUID of the object.
    - `typeName` string — The name of the type.
    - `uniqueAttributes` object — The unique attributes of the object.
    - `displayText` string — The display text.
    - `entityStatus` 'ACTIVE' | 'DELETED' — Status - can be active or deleted
    - `relationshipType` string — Relationship type
    - `relationshipAttributes` AtlasStruct — Captures details of struct contents. Not instantiated directly, used only via AtlasEntity, AtlasClassification.
      - `attributes` object — The attributes of the struct.
      - `typeName` string — The name of the type.
      - `lastModifiedTS` string — ETag for concurrency control.
    - `relationshipGuid` string, uuid — Universally Unique Identifier
    - `relationshipStatus` 'ACTIVE' | 'DELETED' — Status for atlas relationship
  - `categories` AtlasTermCategorizationHeader[] — An array of term categorization headers.
    - `categoryGuid` string, uuid — Universally Unique Identifier
    - `description` string — The description of the record.
    - `displayText` string — The display text.
    - `relationGuid` string, uuid — Universally Unique Identifier
    - `status` 'DRAFT' | 'ACTIVE' | 'DEPRECATED' | 'OBSOLETE' | 'OTHER' — Status for atlas term relationship
  - `classifies` AtlasRelatedTermHeader[] — An array of related term headers.
    - `description` string — The description of the related term.
    - `displayText` string — The display text.
    - `expression` string — The expression of the term.
    - `relationGuid` string — The GUID of the relationship.
    - `status` 'DRAFT' | 'ACTIVE' | 'DEPRECATED' | 'OBSOLETE' | 'OTHER' — Status for atlas term relationship
    - `steward` string — The steward of the term.
    - `termGuid` string — The GUID of the term.
  - `examples` string[] — An array of examples.
  - `isA` AtlasRelatedTermHeader[] — An array of related term headers indicating the is-a relationship.
    - `description` string — The description of the related term.
    - `displayText` string — The display text.
    - `expression` string — The expression of the term.
    - `relationGuid` string — The GUID of the relationship.
    - `status` 'DRAFT' | 'ACTIVE' | 'DEPRECATED' | 'OBSOLETE' | 'OTHER' — Status for atlas term relationship
    - `steward` string — The steward of the term.
    - `termGuid` string — The GUID of the term.
  - `preferredTerms` AtlasRelatedTermHeader[] — An array of preferred related term headers.
    - `description` string — The description of the related term.
    - `displayText` string — The display text.
    - `expression` string — The expression of the term.
    - `relationGuid` string — The GUID of the relationship.
    - `status` 'DRAFT' | 'ACTIVE' | 'DEPRECATED' | 'OBSOLETE' | 'OTHER' — Status for atlas term relationship
    - `steward` string — The steward of the term.
    - `termGuid` string — The GUID of the term.
  - `preferredToTerms` AtlasRelatedTermHeader[] — An array of related term headers that are preferred to.
    - `description` string — The description of the related term.
    - `displayText` string — The display text.
    - `expression` string — The expression of the term.
    - `relationGuid` string — The GUID of the relationship.
    - `status` 'DRAFT' | 'ACTIVE' | 'DEPRECATED' | 'OBSOLETE' | 'OTHER' — Status for atlas term relationship
    - `steward` string — The steward of the term.
    - `termGuid` string — The GUID of the term.
  - `replacedBy` AtlasRelatedTermHeader[] — An array of related term headers that are replaced by.
    - `description` string — The description of the related term.
    - `displayText` string — The display text.
    - `expression` string — The expression of the term.
    - `relationGuid` string — The GUID of the relationship.
    - `status` 'DRAFT' | 'ACTIVE' | 'DEPRECATED' | 'OBSOLETE' | 'OTHER' — Status for atlas term relationship
    - `steward` string — The steward of the term.
    - `termGuid` string — The GUID of the term.
  - `replacementTerms` AtlasRelatedTermHeader[] — An array of related term headers for replacement.
    - `description` string — The description of the related term.
    - `displayText` string — The display text.
    - `expression` string — The expression of the term.
    - `relationGuid` string — The GUID of the relationship.
    - `status` 'DRAFT' | 'ACTIVE' | 'DEPRECATED' | 'OBSOLETE' | 'OTHER' — Status for atlas term relationship
    - `steward` string — The steward of the term.
    - `termGuid` string — The GUID of the term.
  - `seeAlso` AtlasRelatedTermHeader[] — An array of related term headers for see also.
    - `description` string — The description of the related term.
    - `displayText` string — The display text.
    - `expression` string — The expression of the term.
    - `relationGuid` string — The GUID of the relationship.
    - `status` 'DRAFT' | 'ACTIVE' | 'DEPRECATED' | 'OBSOLETE' | 'OTHER' — Status for atlas term relationship
    - `steward` string — The steward of the term.
    - `termGuid` string — The GUID of the term.
  - `synonyms` AtlasRelatedTermHeader[] — An array of related term headers as synonyms.
    - `description` string — The description of the related term.
    - `displayText` string — The display text.
    - `expression` string — The expression of the term.
    - `relationGuid` string — The GUID of the relationship.
    - `status` 'DRAFT' | 'ACTIVE' | 'DEPRECATED' | 'OBSOLETE' | 'OTHER' — Status for atlas term relationship
    - `steward` string — The steward of the term.
    - `termGuid` string — The GUID of the term.
  - `translatedTerms` AtlasRelatedTermHeader[] — An array of translated related term headers.
    - `description` string — The description of the related term.
    - `displayText` string — The display text.
    - `expression` string — The expression of the term.
    - `relationGuid` string — The GUID of the relationship.
    - `status` 'DRAFT' | 'ACTIVE' | 'DEPRECATED' | 'OBSOLETE' | 'OTHER' — Status for atlas term relationship
    - `steward` string — The steward of the term.
    - `termGuid` string — The GUID of the term.
  - `translationTerms` AtlasRelatedTermHeader[] — An array of related term headers for translation.
    - `description` string — The description of the related term.
    - `displayText` string — The display text.
    - `expression` string — The expression of the term.
    - `relationGuid` string — The GUID of the relationship.
    - `status` 'DRAFT' | 'ACTIVE' | 'DEPRECATED' | 'OBSOLETE' | 'OTHER' — Status for atlas term relationship
    - `steward` string — The steward of the term.
    - `termGuid` string — The GUID of the term.
  - `usage` string — The usage of the term.
  - `validValues` AtlasRelatedTermHeader[] — An array of related term headers as valid values.
    - `description` string — The description of the related term.
    - `displayText` string — The display text.
    - `expression` string — The expression of the term.
    - `relationGuid` string — The GUID of the relationship.
    - `status` 'DRAFT' | 'ACTIVE' | 'DEPRECATED' | 'OBSOLETE' | 'OTHER' — Status for atlas term relationship
    - `steward` string — The steward of the term.
    - `termGuid` string — The GUID of the term.
  - `validValuesFor` AtlasRelatedTermHeader[] — An array of related term headers as valid values for other records.
    - `description` string — The description of the related term.
    - `displayText` string — The display text.
    - `expression` string — The expression of the term.
    - `relationGuid` string — The GUID of the relationship.
    - `status` 'DRAFT' | 'ACTIVE' | 'DEPRECATED' | 'OBSOLETE' | 'OTHER' — Status for atlas term relationship
    - `steward` string — The steward of the term.
    - `termGuid` string — The GUID of the term.

## Response `200`

The request has succeeded.

- AtlasGlossaryTerm[]
  - `guid` string — The GUID of the object.
  - `classifications` AtlasClassification[] — An array of classifications.
    - `attributes` object — The attributes of the struct.
    - `typeName` string — The name of the type.
    - `lastModifiedTS` string — ETag for concurrency control.
    - `entityGuid` string — The GUID of the entity.
    - `entityStatus` 'ACTIVE' | 'DELETED' — Status - can be active or deleted
    - `removePropagationsOnEntityDelete` boolean — Determines if propagations will be removed on entity deletion.
    - `validityPeriods` TimeBoundary[] — An array of time boundaries indicating validity periods.
      - `endTime` string — The end of the time boundary.
      - `startTime` string — The start of the time boundary.
      - `timeZone` string — The timezone of the time boundary.
  - `longDescription` string — The long version description.
  - `name` string — The name of the glossary object.
  - `qualifiedName` string — The qualified name of the glossary object.
  - `shortDescription` string — The short version of description.
  - `lastModifiedTS` string — ETag for concurrency control.
  - `createTime` integer — The created time of the record.
  - `createdBy` string — The user who created the record.
  - `updateTime` integer — The update time of the record.
  - `updatedBy` string — The user who updated the record.
  - `abbreviation` string — The abbreviation of the term.
  - `templateName` unknown[] — The name of the template.
    - unknown
  - `anchor` AtlasGlossaryHeader — The glossary header with basic information.
    - `displayText` string — The display text.
    - `glossaryGuid` string — The GUID of the glossary.
    - `relationGuid` string — The GUID of the relationship.
  - `antonyms` AtlasRelatedTermHeader[] — An array of related term headers as antonyms.
    - `description` string — The description of the related term.
    - `displayText` string — The display text.
    - `expression` string — The expression of the term.
    - `relationGuid` string — The GUID of the relationship.
    - `status` 'DRAFT' | 'ACTIVE' | 'DEPRECATED' | 'OBSOLETE' | 'OTHER' — Status for atlas term relationship
    - `steward` string — The steward of the term.
    - `termGuid` string — The GUID of the term.
  - `status` 'Draft' | 'Approved' | 'Alert' | 'Expired' — Status for term
  - `nickName` string — The nick name of the term.
  - `hierarchyInfo` PurviewObjectId[] — The hierarchy information of the term.
    - `guid` string — The GUID of the object.
    - `typeName` string — The name of the type.
    - `uniqueAttributes` object — The unique attributes of the object.
    - `name` string — Name
    - `displayText` string — Display text
    - `itemPath` string — Item path
    - `resourceId` string — Resource Id
    - `properties` object — Dictionary of <any>
  - `resources` ResourceLink[] — An array of resource link for term
    - `displayName` string — Display name for url.
    - `url` string — web url. http or https
  - `contacts` object — The dictionary of contacts for terms. Key could be Expert or Steward.
  - `attributes` object — The custom attributes of the term, which is map<string,map<string,object>>. The key of the first layer map is term template name.
  - `assignedEntities` AtlasRelatedObjectId[] — An array of related object IDs.
    - `guid` string — The GUID of the object.
    - `typeName` string — The name of the type.
    - `uniqueAttributes` object — The unique attributes of the object.
    - `displayText` string — The display text.
    - `entityStatus` 'ACTIVE' | 'DELETED' — Status - can be active or deleted
    - `relationshipType` string — Relationship type
    - `relationshipAttributes` AtlasStruct — Captures details of struct contents. Not instantiated directly, used only via AtlasEntity, AtlasClassification.
      - `attributes` object — The attributes of the struct.
      - `typeName` string — The name of the type.
      - `lastModifiedTS` string — ETag for concurrency control.
    - `relationshipGuid` string, uuid — Universally Unique Identifier
    - `relationshipStatus` 'ACTIVE' | 'DELETED' — Status for atlas relationship
  - `categories` AtlasTermCategorizationHeader[] — An array of term categorization headers.
    - `categoryGuid` string, uuid — Universally Unique Identifier
    - `description` string — The description of the record.
    - `displayText` string — The display text.
    - `relationGuid` string, uuid — Universally Unique Identifier
    - `status` 'DRAFT' | 'ACTIVE' | 'DEPRECATED' | 'OBSOLETE' | 'OTHER' — Status for atlas term relationship
  - `classifies` AtlasRelatedTermHeader[] — An array of related term headers.
    - `description` string — The description of the related term.
    - `displayText` string — The display text.
    - `expression` string — The expression of the term.
    - `relationGuid` string — The GUID of the relationship.
    - `status` 'DRAFT' | 'ACTIVE' | 'DEPRECATED' | 'OBSOLETE' | 'OTHER' — Status for atlas term relationship
    - `steward` string — The steward of the term.
    - `termGuid` string — The GUID of the term.
  - `examples` string[] — An array of examples.
  - `isA` AtlasRelatedTermHeader[] — An array of related term headers indicating the is-a relationship.
    - `description` string — The description of the related term.
    - `displayText` string — The display text.
    - `expression` string — The expression of the term.
    - `relationGuid` string — The GUID of the relationship.
    - `status` 'DRAFT' | 'ACTIVE' | 'DEPRECATED' | 'OBSOLETE' | 'OTHER' — Status for atlas term relationship
    - `steward` string — The steward of the term.
    - `termGuid` string — The GUID of the term.
  - `preferredTerms` AtlasRelatedTermHeader[] — An array of preferred related term headers.
    - `description` string — The description of the related term.
    - `displayText` string — The display text.
    - `expression` string — The expression of the term.
    - `relationGuid` string — The GUID of the relationship.
    - `status` 'DRAFT' | 'ACTIVE' | 'DEPRECATED' | 'OBSOLETE' | 'OTHER' — Status for atlas term relationship
    - `steward` string — The steward of the term.
    - `termGuid` string — The GUID of the term.
  - `preferredToTerms` AtlasRelatedTermHeader[] — An array of related term headers that are preferred to.
    - `description` string — The description of the related term.
    - `displayText` string — The display text.
    - `expression` string — The expression of the term.
    - `relationGuid` string — The GUID of the relationship.
    - `status` 'DRAFT' | 'ACTIVE' | 'DEPRECATED' | 'OBSOLETE' | 'OTHER' — Status for atlas term relationship
    - `steward` string — The steward of the term.
    - `termGuid` string — The GUID of the term.
  - `replacedBy` AtlasRelatedTermHeader[] — An array of related term headers that are replaced by.
    - `description` string — The description of the related term.
    - `displayText` string — The display text.
    - `expression` string — The expression of the term.
    - `relationGuid` string — The GUID of the relationship.
    - `status` 'DRAFT' | 'ACTIVE' | 'DEPRECATED' | 'OBSOLETE' | 'OTHER' — Status for atlas term relationship
    - `steward` string — The steward of the term.
    - `termGuid` string — The GUID of the term.
  - `replacementTerms` AtlasRelatedTermHeader[] — An array of related term headers for replacement.
    - `description` string — The description of the related term.
    - `displayText` string — The display text.
    - `expression` string — The expression of the term.
    - `relationGuid` string — The GUID of the relationship.
    - `status` 'DRAFT' | 'ACTIVE' | 'DEPRECATED' | 'OBSOLETE' | 'OTHER' — Status for atlas term relationship
    - `steward` string — The steward of the term.
    - `termGuid` string — The GUID of the term.
  - `seeAlso` AtlasRelatedTermHeader[] — An array of related term headers for see also.
    - `description` string — The description of the related term.
    - `displayText` string — The display text.
    - `expression` string — The expression of the term.
    - `relationGuid` string — The GUID of the relationship.
    - `status` 'DRAFT' | 'ACTIVE' | 'DEPRECATED' | 'OBSOLETE' | 'OTHER' — Status for atlas term relationship
    - `steward` string — The steward of the term.
    - `termGuid` string — The GUID of the term.
  - `synonyms` AtlasRelatedTermHeader[] — An array of related term headers as synonyms.
    - `description` string — The description of the related term.
    - `displayText` string — The display text.
    - `expression` string — The expression of the term.
    - `relationGuid` string — The GUID of the relationship.
    - `status` 'DRAFT' | 'ACTIVE' | 'DEPRECATED' | 'OBSOLETE' | 'OTHER' — Status for atlas term relationship
    - `steward` string — The steward of the term.
    - `termGuid` string — The GUID of the term.
  - `translatedTerms` AtlasRelatedTermHeader[] — An array of translated related term headers.
    - `description` string — The description of the related term.
    - `displayText` string — The display text.
    - `expression` string — The expression of the term.
    - `relationGuid` string — The GUID of the relationship.
    - `status` 'DRAFT' | 'ACTIVE' | 'DEPRECATED' | 'OBSOLETE' | 'OTHER' — Status for atlas term relationship
    - `steward` string — The steward of the term.
    - `termGuid` string — The GUID of the term.
  - `translationTerms` AtlasRelatedTermHeader[] — An array of related term headers for translation.
    - `description` string — The description of the related term.
    - `displayText` string — The display text.
    - `expression` string — The expression of the term.
    - `relationGuid` string — The GUID of the relationship.
    - `status` 'DRAFT' | 'ACTIVE' | 'DEPRECATED' | 'OBSOLETE' | 'OTHER' — Status for atlas term relationship
    - `steward` string — The steward of the term.
    - `termGuid` string — The GUID of the term.
  - `usage` string — The usage of the term.
  - `validValues` AtlasRelatedTermHeader[] — An array of related term headers as valid values.
    - `description` string — The description of the related term.
    - `displayText` string — The display text.
    - `expression` string — The expression of the term.
    - `relationGuid` string — The GUID of the relationship.
    - `status` 'DRAFT' | 'ACTIVE' | 'DEPRECATED' | 'OBSOLETE' | 'OTHER' — Status for atlas term relationship
    - `steward` string — The steward of the term.
    - `termGuid` string — The GUID of the term.
  - `validValuesFor` AtlasRelatedTermHeader[] — An array of related term headers as valid values for other records.
    - `description` string — The description of the related term.
    - `displayText` string — The display text.
    - `expression` string — The expression of the term.
    - `relationGuid` string — The GUID of the relationship.
    - `status` 'DRAFT' | 'ACTIVE' | 'DEPRECATED' | 'OBSOLETE' | 'OTHER' — Status for atlas term relationship
    - `steward` string — The steward of the term.
    - `termGuid` string — The GUID of the term.

## Other responses

- `default` — An unexpected error response.

---

[API](https://skmtc.net/azure/apis/purview-datamap.md) · [All operations](https://skmtc.net/azure/apis/purview-datamap/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/purview-datamap/versions/442226cb14a9/schema)