Add metadata taxonomy level

Creates a new metadata taxonomy level and appends it to the existing levels. If there are no levels defined yet, this will create the first level.

POST /metadata_taxonomies/{namespace}/{taxonomy_key}/levels:append

Add metadata taxonomy level

cURL

curl --request POST \
  --url https://api.box.com/2.0/metadata_taxonomies/{namespace}/{taxonomy_key}/levels:append \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "displayName": "France",
  "description": "French Republic"
}
'

201

{
  "entries": [
    {
      "displayName": "Continent",
      "description": "Continent",
      "level": 1
    }
  ]
}

このリソースは、バージョン2024.0のエンドポイントで使用されています。 詳細については、 Box APIのバージョン管理を参照してください。

「Box SDKのバージョニング戦略について詳しく学ぶ。」

承認

Authorization · string · header · 必須

The access token received from the authorization server in the OAuth 2.0 flow.

パスパラメータ

namespace · string · 必須

The namespace of the metadata taxonomy.

taxonomy_key · string · 必須

The key of the metadata taxonomy.

ボディ

application/json

displayName · string · 必須

The display name of the taxonomy level.

例:

"France"

description · string

The description of the taxonomy level.

例:

"French Republic"

レスポンス

201

application/json

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.

表示 子属性