BObox
Metadata taxonomies

Add metadata taxonomy level

Changed on

Creates a new metadata taxonomy level and appends it to the existing levels. If there are no levels defined yet, this will create the first level.

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

Request

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

descriptionstring

The description of the taxonomy level.

Example request

{
  "displayName": "France",
  "description": "French Republic"
}

Response

Returns an array of all taxonomy levels.

Example response

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

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