Sign in

v1

latestOpenAPI 3.0.2Apache-2.02026-07-142963051.0 MB
Metadata taxonomies

Update metadata taxonomy

Updates an existing metadata taxonomy.

patch/metadata_taxonomies/{namespace}/{taxonomy_key}

Path parameters

namespacestring required

The namespace of the metadata taxonomy.

taxonomy_keystring required

The key of the metadata taxonomy.

Request body

displayNamestring required

The display name of the taxonomy.

Example request

{
  "displayName": "Geography"
}

Response

The schema representing the updated metadata taxonomy.

idstring required

A unique identifier of the metadata taxonomy.

keystring

A unique identifier of the metadata taxonomy. The identifier must be unique within the namespace to which it belongs.

displayNamestring required

The display name of the metadata taxonomy. This can be seen in the Box web app.

namespacestring required

A namespace that the metadata taxonomy is associated with.

Example response

{
  "id": "822227e0-47a5-921b-88a8-494760b2e6d2",
  "key": "geography",
  "displayName": "Geography",
  "namespace": "enterprise_123456",
  "levels": [
    {
      "displayName": "Continent",
      "description": "Continent",
      "level": 1
    }
  ]
}