Skip to main content
PATCH
/
metadata_taxonomies
/
{namespace}
/
{taxonomy_key}
/
levels
/
{level_index}
Update metadata taxonomy level
curl --request PATCH \
  --url https://api.box.com/2.0/metadata_taxonomies/{namespace}/{taxonomy_key}/levels/{level_index} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "displayName": "France",
  "description": "French Republic"
}
'
{
  "displayName": "Continent",
  "description": "Continent",
  "level": 1
}
This endpoint is in the version 2024.0. No changes are required to continue using it. For more details, see Box API versioning.Learn more about Box SDK versioning strategy.

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

​
namespace
string
required

The namespace of the metadata taxonomy.

​
taxonomy_key
string
required

The key of the metadata taxonomy.

​
level_index
integer
required

The index of the metadata taxonomy level.

Body

application/json
​
displayName
string
required

The display name of the taxonomy level.

Example:

"France"

​
description
string

The description of the taxonomy level.

Example:

"French Republic"

Response

The updated taxonomy level.

A level in the metadata taxonomy represents a hierarchical category within the taxonomy structure.

​
displayName
string

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

Example:

"Continent"

​
description
string

A description of the level.

Example:

"Continent"

​
level
integer<int32>

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

Example:

1