---
title: "POST /terms"
method: POST
path: "/terms"
tags: ["Term"]
---

# POST /terms

`POST /terms`

Creates a new term in the catalog. Rate limit: 200 requests per 20-second window.

## Query parameters

- `api-version` string, required

## Request body

- Term — Microsoft Purview Data Governance Catalog Model Term.
  - `status` 'DRAFT' | 'PUBLISHED' | 'EXPIRED', required — Status of a catalog model entity indicating its lifecycle state.
  - `id` string, uuid, required — Universally Unique Identifier
  - `name` string, required — The name of the term.
  - `systemData` CatalogModelSystemDataWithExpired — System metadata with expiration information for catalog entities.
    - `provisioningState` 'Unknown' | 'Succeeded' | 'SoftDeleted' — The provisioning state of a data asset.
    - `createdAt` string, date-time — The timestamp when the record was created.
    - `createdBy` string, uuid — Universally Unique Identifier
    - `lastModifiedAt` string, date-time — The timestamp when the record was last modified.
    - `lastModifiedBy` string, uuid — Universally Unique Identifier
    - `expiredAt` string, date-time — The timestamp when the record expires.
    - `expiredBy` string, uuid — Universally Unique Identifier
  - `description` string — The description of the term.
  - `contacts` ContactsMap — A dictionary of contact lists keyed by contact type (e.g., 'Owner', 'Expert').
    - `owner` CatalogModelContactsValueInner[] — List of owner contacts.
      - `id` string, uuid — Universally Unique Identifier
      - `description` string — A description of this user assignment
    - `expert` CatalogModelContactsValueInner[] — List of expert contacts.
      - `id` string, uuid — Universally Unique Identifier
      - `description` string — A description of this user assignment
    - `databaseAdmin` CatalogModelContactsValueInner[] — List of database administrator contacts.
      - `id` string, uuid — Universally Unique Identifier
      - `description` string — A description of this user assignment
  - `domain` string, uuid, required — Universally Unique Identifier
  - `parentId` string, uuid — Universally Unique Identifier
  - `acronyms` string[] — The list of acronyms for the term.
  - `resources` CatalogModelTermResource[] — The resources associated with the term.
    - `name` string — The name of the resource.
    - `url` string, uri — The URL of the resource.
  - `isLeaf` boolean — Whether the term is a leaf node.
  - `managedAttributes` CatalogModelManagedAttribute[] — The managed attributes associated with the term.
    - `name` string — The name of the managed attribute.
    - `value` string — The value of the attribute.
    - `isRequired` boolean — Whether this attribute is required.

## Response `201`

The request has succeeded and a new resource has been created as a result.

- Term — Microsoft Purview Data Governance Catalog Model Term.
  - `status` 'DRAFT' | 'PUBLISHED' | 'EXPIRED', required — Status of a catalog model entity indicating its lifecycle state.
  - `id` string, uuid, required — Universally Unique Identifier
  - `name` string, required — The name of the term.
  - `systemData` CatalogModelSystemDataWithExpired — System metadata with expiration information for catalog entities.
    - `provisioningState` 'Unknown' | 'Succeeded' | 'SoftDeleted' — The provisioning state of a data asset.
    - `createdAt` string, date-time — The timestamp when the record was created.
    - `createdBy` string, uuid — Universally Unique Identifier
    - `lastModifiedAt` string, date-time — The timestamp when the record was last modified.
    - `lastModifiedBy` string, uuid — Universally Unique Identifier
    - `expiredAt` string, date-time — The timestamp when the record expires.
    - `expiredBy` string, uuid — Universally Unique Identifier
  - `description` string — The description of the term.
  - `contacts` ContactsMap — A dictionary of contact lists keyed by contact type (e.g., 'Owner', 'Expert').
    - `owner` CatalogModelContactsValueInner[] — List of owner contacts.
      - `id` string, uuid — Universally Unique Identifier
      - `description` string — A description of this user assignment
    - `expert` CatalogModelContactsValueInner[] — List of expert contacts.
      - `id` string, uuid — Universally Unique Identifier
      - `description` string — A description of this user assignment
    - `databaseAdmin` CatalogModelContactsValueInner[] — List of database administrator contacts.
      - `id` string, uuid — Universally Unique Identifier
      - `description` string — A description of this user assignment
  - `domain` string, uuid, required — Universally Unique Identifier
  - `parentId` string, uuid — Universally Unique Identifier
  - `acronyms` string[] — The list of acronyms for the term.
  - `resources` CatalogModelTermResource[] — The resources associated with the term.
    - `name` string — The name of the resource.
    - `url` string, uri — The URL of the resource.
  - `isLeaf` boolean — Whether the term is a leaf node.
  - `managedAttributes` CatalogModelManagedAttribute[] — The managed attributes associated with the term.
    - `name` string — The name of the managed attribute.
    - `value` string — The value of the attribute.
    - `isRequired` boolean — Whether this attribute is required.

## Other responses

- `default` — An unexpected error response.

---

[API](https://skmtc.net/azure/apis/purviewdatagovernance-azure-analytics-purview-unifiedcatalog.md) · [All operations](https://skmtc.net/azure/apis/purviewdatagovernance-azure-analytics-purview-unifiedcatalog/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/purviewdatagovernance-azure-analytics-purview-unifiedcatalog/versions/70d32c954a8c/schema)