List Taxonomies

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.

Query Parameters

offset_id

string | null

The offset id to start returning results from. Used for pagination

page_size

integer

default:

Response

200 - application/json

pagination

object

required

Pagination information

results

object[]

required

List of fully populated taxonomies with nodes

results.nodes

object[]

required

Taxonomy nodes

results.nodes.embedding_configs

object[]

required

List of embedding configurations defining how this node should be vectorized

results.nodes.node_name

string

required

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

results.nodes.taxonomy_id

string

required

ID of the taxonomy this node belongs to

results.nodes.children

object[] | null

List of child nodes under this node

results.nodes.children.embedding_configs

object[]

required

List of embedding configurations defining how this node should be vectorized

results.nodes.children.node_name

string

required

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

results.nodes.children.taxonomy_id

string

required

ID of the taxonomy this node belongs to

results.nodes.children.children

object[] | null

List of child nodes under this node

results.nodes.children.depth

integer

default:

Depth of the node in the taxonomy

results.nodes.children.node_description

string | null

Optional description of what this node represents

results.nodes.children.node_id

string

Unique identifier for the taxonomy node

results.nodes.children.order

integer[]

Order of the node in the taxonomy

results.nodes.children.parent_node_id

string | null

ID of the parent node (None if root node)

results.nodes.children.path_tokens

string[]

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

results.nodes.depth

integer

default:

Depth of the node in the taxonomy

results.nodes.node_description

string | null

Optional description of what this node represents

results.nodes.node_id

string

Unique identifier for the taxonomy node

results.nodes.order

integer[]

Order of the node in the taxonomy

results.nodes.parent_node_id

string | null

ID of the parent node (None if root node)

results.nodes.path_tokens

string[]

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

results.taxonomy_name

string

required

Taxonomy name

results.taxonomy_id

string

Auto-generated taxonomy identifier

Health

Features

Ingest Assets

Entities

Assets

Collections

Namespaces

Feature Extractors

Tasks

List Taxonomies

Headers

Query Parameters

Response