メインコンテンツへスキップ
POST
/
metadata_taxonomies
/
{namespace}
/
{taxonomy_key}
/
nodes
cURL
curl --request POST \
  --url https://api.box.com/2.0/metadata_taxonomies/{namespace}/{taxonomy_key}/nodes \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "displayName": "France",
  "level": 1,
  "parentId": "99df4513-7102-4896-8228-94635ee9d330"
}
'
{
  "id": "14d3d433-c77f-49c5-b146-9dea370f6e32",
  "displayName": "France",
  "level": 2,
  "parentId": "99df4513-7102-4896-8228-94635ee9d330",
  "nodePath": [
    "99df4513-7102-4896-8228-94635ee9d330"
  ],
  "ancestors": [
    {
      "id": "14d3d433-c77f-49c5-b146-9dea370f6e32",
      "displayName": "France",
      "level": 2
    }
  ]
}
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.

認証

​
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 node.

例:

"France"

​
level
integer
必須

The level of the taxonomy node.

例:

1

​
parentId
string

The identifier of the parent taxonomy node. Omit this field for root-level nodes.

例:

"99df4513-7102-4896-8228-94635ee9d330"

レスポンス

The schema representing the taxonomy node created.

A node object for metadata taxonomy that can be used in metadata templates.

​
id
string
必須

A unique identifier of the metadata taxonomy node.

例:

"14d3d433-c77f-49c5-b146-9dea370f6e32"

​
displayName
string
必須

The display name of the metadata taxonomy node.

例:

"France"

​
level
integer
必須

An index of the level to which the node belongs.

例:

2

​
parentId
string

The identifier of the parent node.

例:

"99df4513-7102-4896-8228-94635ee9d330"

​
nodePath
string[]

An array of identifiers for all ancestor nodes.
Not returned for root-level nodes.

例:
["99df4513-7102-4896-8228-94635ee9d330"]
​
ancestors
Metadata taxonomy ancestor · object[]

An array of objects for all ancestor nodes.
Not returned for root-level nodes.