BObox
Metadata taxonomies

Create metadata taxonomy node

Changed on

Creates a new metadata taxonomy node.

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

Request

  • Base URL
    https://api.box.com/2.0
  • URL
    https://api.box.com/2.0/metadata_taxonomies/{namespace}/{taxonomy_key}/nodes
  • Auth
    OAuth 2
    Authorization code: https://account.box.com/api/oauth2/authorize
    Token URL: https://api.box.com/oauth2/token

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
    }
  ]
}

Changes

  • c4d5303fa5c3Revision changes
    • warning

      added the new unprocessable_entity enum value to the response property for the response status

    • warning

      added the new unprocessable_entity enum value to the response property for the response status

    • warning

      added the new unprocessable_entity enum value to the response property for the response status