Skip to main content
Remove metadata taxonomies and their structural components. Taxonomy deletion is permanent and irreversible, so use with caution.

​
Delete a metadata taxonomy

Deletes an entire metadata taxonomy and all associated levels and nodes. This action cannot be undone. The taxonomy and its nodes will no longer be accessible for metadata templates or other API calls. Call the DELETE /metadata_taxonomies/{namespace}/{taxonomy_key} API endpoint. 
curl --request DELETE \ 
--url "https://api.box.com/2.0/metadata_taxonomies/{namespace}/{taxonomy_key}" \ 
--header "Authorization: Bearer YOUR_ACCESS_TOKEN"
Additional information is available for the namespace and taxonomy_key of a taxonomy.

​
Remove a metadata taxonomy node

Deletes a specific node within a taxonomy. If the node has child nodes, you must delete those children first before you can remove the parent node. This endpoint does not cascade; it only deletes individual nodes that have no children under them. Call the DELETE /metadata_taxonomies/{namespace}/{taxonomy_key}/nodes/{node_id} API endpoint. 
curl --request DELETE \ 
--url "https://api.box.com/2.0/metadata_taxonomies/{namespace}/{taxonomy_key}/nodes/{node_id}" \ 
--header "Authorization: Bearer YOUR_ACCESS_TOKEN"
Additional information is available for the namespace, taxonomy_key, and node_id of a taxonomy.

​
Remove the last level of a taxonomy

Removes the last level of a taxonomy’s hierarchy. Levels are evaluated in hierarchical order, and this call trims only the deepest level. Call the POST /metadata_taxonomies/{namespace}/{taxonomy_key}/levels:trim API endpoint. 

curl --request POST \ 
--url "https://api.box.com/2.0/metadata_taxonomies/{namespace}/{taxonomy_key}/levels:trim" \ 
--header "Authorization: Bearer YOUR_ACCESS_TOKEN"
Additional information is available for the namespace and taxonomy_key of a taxonomy.