Update Taxonomy

Headers

Authorization

string | null

Bearer token authentication using your API key. Format: 'Bearer your_api_key'. To get an API key, create an account at mixpeek.com/start and generate a key in your account settings. Example: 'Bearer sk_1234567890abcdef'

X-Namespace

string | null

Optional namespace for data isolation. This can be a namespace name or namespace ID. Example: 'netflix_prod' or 'ns_1234567890'. To create a namespace, use the /namespaces endpoint.

Path Parameters

taxonomy

string

required

The ID or name of the taxonomy to update

Body

application/json

Model for updating specific taxonomy fields

description

string | null

Updated taxonomy description

taxonomy_name

string | null

Updated taxonomy name (must not contain spaces or special characters)

Response

200 - application/json

nodes

object[]

required

Taxonomy nodes

nodes.embedding_configs

object[]

required

List of embedding configurations defining how this node should be vectorized

nodes.node_name

string

required

Name of the taxonomy node (must be lowercase without spaces)

nodes.taxonomy_id

string

required

ID of the taxonomy this node belongs to

nodes.children

object[] | null

List of child nodes under this node

nodes.children.embedding_configs

object[]

required

List of embedding configurations defining how this node should be vectorized

nodes.children.node_name

string

required

Name of the taxonomy node (must be lowercase without spaces)

nodes.children.taxonomy_id

string

required

ID of the taxonomy this node belongs to

nodes.children.children

object[] | null

List of child nodes under this node

nodes.children.children.embedding_configs

object[]

required

List of embedding configurations defining how this node should be vectorized

nodes.children.children.node_name

string

required

Name of the taxonomy node (must be lowercase without spaces)

nodes.children.children.taxonomy_id

string

required

ID of the taxonomy this node belongs to

nodes.children.children.children

object[] | null

List of child nodes under this node

nodes.children.children.depth

integer

default:

Depth of the node in the taxonomy

nodes.children.children.node_description

string | null

Optional description of what this node represents

nodes.children.children.node_id

string

Unique identifier for the taxonomy node

nodes.children.children.order

integer[]

Order of the node in the taxonomy

nodes.children.children.parent_node_id

string | null

ID of the parent node (None if root node)

nodes.children.children.path_tokens

string[]

List of node names representing the path from root to this node

nodes.children.depth

integer

default:

Depth of the node in the taxonomy

nodes.children.node_description

string | null

Optional description of what this node represents

nodes.children.node_id

string

Unique identifier for the taxonomy node

nodes.children.order

integer[]

Order of the node in the taxonomy

nodes.children.parent_node_id

string | null

ID of the parent node (None if root node)

nodes.children.path_tokens

string[]

List of node names representing the path from root to this node

nodes.depth

integer

default:

Depth of the node in the taxonomy

nodes.node_description

string | null

Optional description of what this node represents

nodes.node_id

string

Unique identifier for the taxonomy node

nodes.order

integer[]

Order of the node in the taxonomy

nodes.parent_node_id

string | null

ID of the parent node (None if root node)

nodes.path_tokens

string[]

List of node names representing the path from root to this node

taxonomy_name

string

required

Taxonomy name

taxonomy_id

string

Auto-generated taxonomy identifier

Health

Features

Ingest Assets

Entities

Assets

Collections

Namespaces

Feature Extractors

Tasks

Update Taxonomy

Headers

Path Parameters

Body

Response