BObox
Metadata taxonomies

Update metadata taxonomy level

Changed on

Updates an existing metadata taxonomy level.

patch/metadata_taxonomies/{namespace}/{taxonomy_key}/levels/{level_index}

Request

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

level_indexinteger required

The index of the metadata taxonomy level.

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

The updated taxonomy level.

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 response

{
  "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