Skip to main content
POST
/
metadata_taxonomies
/
{namespace}
/
{taxonomy_key}
/
levels
cURL
curl -i -X POST "https://api.box.com/2.0/metadata_taxonomies/enterprise_123456/geography/levels" \
     -H "authorization: Bearer <ACCESS_TOKEN>" \
     -H "content-type: application/json" \
     -d '[
       {
         "displayName": "Continent",
         "description": "Continent Level"
       },
       {
         "displayName": "Country",
         "description": "Country Level"
       }
     ]'
{
  "entries": [
    {
      "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.

Body

application/json
​
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

Response

Returns an array of all taxonomy levels.

Levels in the metadata taxonomy represent hierarchical categories within the taxonomy structure.

​
entries
Metadata taxonomy level · object[]

An array of all taxonomy levels.