Skip to main content
Update metadata taxonomy elements such as displayNames, descriptions, and other attributes of an existing taxonomy structure.

​
Update a metadata taxonomy

Use this endpoint to update top-level attributes of an existing taxonomy, such as changing its displayName. Call the PATCH /metadata_taxonomies/{namespace}/{taxonomy_key} API endpoint. 
curl --request PATCH \ 
--url "https://api.box.com/2.0/metadata_taxonomies/{namespace}/{taxonomy_key}" \ 
--header "Authorization: Bearer YOUR_ACCESS_TOKEN" \ 
--header "Content-Type: application/json" \ 
--data '{ 
"displayName": "UPDATED DISPLAY NAME" 
}'
Additional information is available for the namespace and taxonomy_key of a taxonomy.

​
Update a taxonomy level

Update the display name and description of an existing level within a taxonomy. The level index identifies which level to update. Call the PATCH /metadata_taxonomies/{namespace}/{taxonomy_key}/levels/{level_index} API endpoint with the displayName and description. 
curl --request PATCH \ 
--url "https://api.box.com/2.0/metadata_taxonomies/{namespace}/{taxonomy_key}/levels/1" \ 
--header "Authorization: Bearer YOUR_ACCESS_TOKEN" \ 
--header "Content-Type: application/json" \ 
--data '{ 
"displayName": "Continent UPDATED", 
"description": "Continent Level UPDATED" 
}'
Additional information is available for the namespace, taxonomy_key, and level_index of a taxonomy.

​
Update a taxonomy node

Use this endpoint to modify the display name or relationship attributes of an existing node in a taxonomy - for example, renaming Paris to Paris City. Call the PATCH /metadata_taxonomies/{namespace}/{taxonomy_key}/nodes/{node_id} API endpoint with the taxonomy’s displayName. 
curl --request PATCH \ 
--url "https://api.box.com/2.0/metadata_taxonomies/{namespace}/{taxonomy_key}/nodes/{node_id}" \ 
--header "Authorization: Bearer YOUR_ACCESS_TOKEN" \ 
--header "Content-Type: application/json" \ 
--data '{ 
"displayName": "Poland UPDATED" 
}'
Additional information is available for the namespace, taxonomy_key, and node_id of a taxonomy.