v1

latestOpenAPI 3.0.2Apache-2.02026-07-142963051.0 MB
Metadata taxonomies

Create metadata taxonomy node

Creates a new metadata taxonomy node.

post/metadata_taxonomies/{namespace}/{taxonomy_key}/nodes

Path parameters

namespacestring required

The namespace of the metadata taxonomy.

taxonomy_keystring required

The key of the metadata taxonomy.

Request body

displayNamestring required

The display name of the taxonomy node.

levelinteger required

The level of the taxonomy node.

parentIdstring

The identifier of the parent taxonomy node. Omit this field for root-level nodes.

Example request

{
  "displayName": "France",
  "level": 1,
  "parentId": "99df4513-7102-4896-8228-94635ee9d330"
}

Response

The schema representing the taxonomy node created.

idstring required

A unique identifier of the metadata taxonomy node.

displayNamestring required

The display name of the metadata taxonomy node.

levelinteger required

An index of the level to which the node belongs.

parentIdstring

The identifier of the parent node.

nodePathstring[]

An array of identifiers for all ancestor nodes.
Not returned for root-level nodes.

Example response

{
  "id": "14d3d433-c77f-49c5-b146-9dea370f6e32",
  "displayName": "France",
  "level": 2,
  "parentId": "99df4513-7102-4896-8228-94635ee9d330",
  "nodePath": [
    "99df4513-7102-4896-8228-94635ee9d330"
  ],
  "ancestors": [
    {
      "id": "14d3d433-c77f-49c5-b146-9dea370f6e32",
      "displayName": "France",
      "level": 2
    }
  ]
}