Metadata taxonomies

Create metadata taxonomy levels

Changed on

Creates new metadata taxonomy levels.

post/metadata_taxonomies/{namespace}/{taxonomy_key}/levels

Request

  • Base URL
    https://api.box.com/2.0
  • URL
    https://api.box.com/2.0/metadata_taxonomies/{namespace}/{taxonomy_key}/levels
  • 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

The display name of the level as it is shown to the user.

descriptionstring

A description of the level.

levelinteger

An index of the level within the taxonomy. Levels are indexed starting from 1.

Example request

[
  {
    "displayName": "Continent",
    "description": "Continent",
    "level": 1
  }
]

Response

Returns an array of all taxonomy levels.

Example response

{
  "entries": [
    {
      "displayName": "Continent",
      "description": "Continent",
      "level": 1
    }
  ]
}

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