Create 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.

Body

application/json

nodes

object[]

required

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.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.children

object[] | null

List of child nodes under this node

nodes.children.node_description

string | null

Optional description of what this node represents

nodes.node_description

string | null

Optional description of what this node represents

taxonomy_name

string

required

Taxonomy name (must not contain spaces or special characters)

Response

200 - application/json

task_id

string

required

inputs

any[] | null

outputs

any[] | null

status

enum<string>

Available options:

DONE,

FAILED,

SKIPPED,

CANCELLED,

PROCESSING,

DOWNLOADING,

INITIALIZING,

UPLOADING,

QUEUED,

PENDING

Health

Features

Ingest Assets

Entities

Assets

Collections

Namespaces

Feature Extractors

Tasks

Create Taxonomy

Headers

Body

Response