> ## Documentation Index
> Fetch the complete documentation index at: https://developer.box.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Update metadata taxonomies
export const Link = ({href, children, className, ...props}) => {
const localizedHref = href;
return
{children}
;
};
export const MultiRelatedLinks = ({sections = []}) => {
if (!sections || sections.length === 0) {
return null;
}
return
{sections.map((section, index) => )}
;
};
export const RelatedLinks = ({title, items = []}) => {
const getBadgeClass = badge => {
if (!badge) return "badge-default";
const badgeType = badge.toLowerCase().replace(/\s+/g, "-");
return `badge-${badge === "ガイド" ? "guide" : badgeType}`;
};
if (!items || items.length === 0) {
return null;
}
return ;
};
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.
```sh cURL theme={null}
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"
}'
```
```python Python v10 theme={null}
client.metadata_taxonomies.update_metadata_taxonomy(
namespace, taxonomy_key, updated_display_name
)
```
```typescript Node/TypeScript v10 theme={null}
await client.metadataTaxonomies.updateMetadataTaxonomy(namespace, taxonomyKey, {
displayName: updatedDisplayName,
} satisfies UpdateMetadataTaxonomyRequestBody);
```
```swift Swift v10 theme={null}
try await client.metadataTaxonomies.updateMetadataTaxonomy(namespace: namespace, taxonomyKey: taxonomyKey, requestBody: UpdateMetadataTaxonomyRequestBody(displayName: updatedDisplayName))
```
```java Java v10 theme={null}
client.getMetadataTaxonomies().updateMetadataTaxonomy(namespace, taxonomyKey, new UpdateMetadataTaxonomyRequestBody(updatedDisplayName))
```
```cs .NET v10 theme={null}
await client.MetadataTaxonomies.UpdateMetadataTaxonomyAsync(namespaceParam: namespaceParam, taxonomyKey: taxonomyKey, requestBody: new UpdateMetadataTaxonomyRequestBody(displayName: updatedDisplayName));
```
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`.
```sh cURL theme={null}
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"
}'
```
```python Python v10 theme={null}
client.metadata_taxonomies.update_metadata_taxonomy_level_by_id(
namespace,
taxonomy_key,
1,
"Continent UPDATED",
description="Continent Level UPDATED",
)
```
```typescript Node/TypeScript v10 theme={null}
await client.metadataTaxonomies.updateMetadataTaxonomyLevelById(
namespace,
taxonomyKey,
1,
{
displayName: 'Continent UPDATED',
description: 'Continent Level UPDATED',
} satisfies UpdateMetadataTaxonomyLevelByIdRequestBody,
);
```
```swift Swift v10 theme={null}
try await client.metadataTaxonomies.updateMetadataTaxonomyLevelById(namespace: namespace, taxonomyKey: taxonomyKey, levelIndex: Int64(1), requestBody: UpdateMetadataTaxonomyLevelByIdRequestBody(displayName: "Continent UPDATED", description: "Continent Level UPDATED"))
```
```java Java v10 theme={null}
client.getMetadataTaxonomies().updateMetadataTaxonomyLevelById(namespace, taxonomyKey, 1L, new UpdateMetadataTaxonomyLevelByIdRequestBody.Builder("Continent UPDATED").description("Continent Level UPDATED").build())
```
```cs .NET v10 theme={null}
await client.MetadataTaxonomies.UpdateMetadataTaxonomyLevelByIdAsync(namespaceParam: namespaceParam, taxonomyKey: taxonomyKey, levelIndex: 1L, requestBody: new UpdateMetadataTaxonomyLevelByIdRequestBody(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`.
```sh cURL theme={null}
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"
}'
```
```python Python v10 theme={null}
client.metadata_taxonomies.update_metadata_taxonomy_node(
namespace, taxonomy_key, country_node.id, display_name="Poland UPDATED"
)
```
```typescript Node/TypeScript v10 theme={null}
await client.metadataTaxonomies.updateMetadataTaxonomyNode(
namespace,
taxonomyKey,
countryNode.id,
{
requestBody: {
displayName: 'Poland UPDATED',
} satisfies UpdateMetadataTaxonomyNodeRequestBody,
} satisfies UpdateMetadataTaxonomyNodeOptionalsInput,
);
```
```swift Swift v10 theme={null}
try await client.metadataTaxonomies.updateMetadataTaxonomyNode(namespace: namespace, taxonomyKey: taxonomyKey, nodeId: countryNode.id, requestBody: UpdateMetadataTaxonomyNodeRequestBody(displayName: "Poland UPDATED"))
```
```java Java v10 theme={null}
client.getMetadataTaxonomies().updateMetadataTaxonomyNode(namespace, taxonomyKey, countryNode.getId(), new UpdateMetadataTaxonomyNodeRequestBody.Builder().displayName("Poland UPDATED").build())
```
```cs .NET v10 theme={null}
await client.MetadataTaxonomies.UpdateMetadataTaxonomyNodeAsync(namespaceParam: namespaceParam, taxonomyKey: taxonomyKey, nodeId: countryNode.Id, requestBody: new UpdateMetadataTaxonomyNodeRequestBody() { DisplayName = "Poland UPDATED" });
```
Additional information is available for the `namespace`, `taxonomy_key`, and `node_id` of a taxonomy.