Headers
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'
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 ID or name
Query Parameters
Optional taxonomy version to execute
Body
Request model for on-demand taxonomy validation and testing.
NOTE: This endpoint only supports ON_DEMAND mode for testing/validation. Batch taxonomy materialization is automatically triggered by the engine after feature extraction completes, based on collection configuration.
Full taxonomy model with configuration (fetched from DB by controller)
{
"config": {
"default_input_mappings": [
{
"input_key": "image_vector",
"path": "features.clip_vit_l_14",
"source_type": "vector"
}
],
"default_retriever_id": "ret_clip_v1",
"source_collection": { "collection_id": "col_products_v1" },
"taxonomy_type": "flat"
},
"namespace_id": "ns_123",
"taxonomy_name": "product_tags",
"taxonomy_type": "flat"
}
{
"config": {
"build_mode": "explicit",
"default_input_mappings": [
{
"input_key": "face_vec",
"path": "features.face",
"source_type": "vector"
}
],
"default_retriever_id": "ret_face_v1",
"hierarchical_nodes": [
{ "collection_id": "col_employees_v1" },
{
"collection_id": "col_executives_v1",
"parent_collection_id": "col_employees_v1"
}
],
"taxonomy_type": "hierarchical"
},
"namespace_id": "ns_123",
"taxonomy_name": "org_hierarchy",
"taxonomy_type": "hierarchical"
}
Optional retriever configuration override for testing. If omitted, uses the retriever configured in the taxonomy. Retriever model.
Optional documents to enrich for testing. If omitted, validates configuration without processing documents.
Collection reference (for context/logging only in ON_DEMAND mode)
Not used in ON_DEMAND mode.
Must be on_demand
. Batch mode is not supported via API.
on_demand
, batch
Batch size for the scroll iterator
1 <= x <= 10000
Additional filters applied to the source collection prior to enrichment. Represents a logical operation (AND, OR, NOT) on filter conditions.
Allows nesting with a defined depth limit.