term resource type

Namespace: microsoft.graph.termStore


APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.

Represents a term used in a term store. A term can be used to represent an object which can then be used as a metadata to tag content. Multiple terms can be organized in a hierarchical manner within a set.

Inherits from entity.


Method Return type Description
List children microsoft.graph.termStore.term collection Get the first level children of a term in a term store.
List relations microsoft.graph.termStore.relation collection Get the relations of a term in a term store.
Create relation microsoft.graph.termStore.relation Create a new relation for a term or a set in a term store.
Create term microsoft.graph.termStore.term Create a new term object in a term store.
Get term microsoft.graph.termStore.term Read the properties and relationships of a term object in a term store.
Update term microsoft.graph.termStore.term Update the properties of a term object in a term store.
Delete term None Delete a term object in a term store.


Property Type Description
createdDateTime DateTimeOffset Date and time of term creation. Read-only.
descriptions microsoft.graph.termStore.localizedDescription collection Description about term that is dependent on the languageTag.
id String Unique identifier of term. Read-Only.
labels microsoft.graph.termStore.localizedLabel collection Label metadata for a term.
lastModifiedDateTime DateTimeOffset Last date and time of term modification. Read-only.
properties microsoft.graph.keyValue collection Collection of properties on the term.


Relationship Type Description
children microsoft.graph.termStore.term collection Children of current term.
relations microsoft.graph.termStore.relation collection To indicate which terms are related to the current term as either pinned or reused.
set microsoft.graph.termStore.set The set in which the term is created.

JSON representation

The following is a JSON representation of the resource.

  "@odata.type": "#microsoft.graph.termStore.term",
  "id": "String (identifier)",
  "labels": [
      "@odata.type": "microsoft.graph.termStore.localizedLabel"
  "createdDateTime": "String (timestamp)",
  "lastModifiedDateTime": "String (timestamp)",
  "descriptions": [
      "@odata.type": "microsoft.graph.termStore.localizedDescription"
  "properties": [
      "@odata.type": "microsoft.graph.keyValue"