Taxonomies
Test taxonomy configuration (validation only)
Changed on⚠️ VALIDATION ENDPOINT ONLY - Not for production enrichment!
post/v1/taxonomies/{taxonomy_identifier}/execute
Request
- Base URL: https://api.mixpeek.com
- URL: https://api.mixpeek.com/v1/taxonomies/{taxonomy_identifier}/execute
- Auth: HTTP bearer and API key in header X-Namespace
Path parameters
taxonomy_identifierstring required
Taxonomy ID or name to validate
Query parameters
versioninteger nullable
Optional taxonomy version (defaults to latest)
Request body
Example request
{
"batch_size": 1000,
"join_mode": "on_demand",
"source_collection_id": "col_catalog_v2",
"target_collection_id": "col_catalog_enriched_v2",
"taxonomy": {
"config": {
"input_mappings": [
{
"input_key": "image_vector",
"path": "features.clip",
"source_type": "vector"
}
],
"retriever_id": "ret_clip_v1",
"source_collection": {
"collection_id": "col_products_v1"
},
"taxonomy_type": "flat"
},
"input_mappings": [
{
"input_key": "image_vector",
"path": "features.clip",
"source_type": "vector"
}
],
"namespace_id": "ns_123",
"retriever_id": "ret_clip_v1",
"taxonomy_name": "product_tags"
}
}Response
Successful Response
Changes
- info
added the new optional request property
////
- info
- warning
removed the optional property
from the response with the status - info
added the non-success response with the status
- info
added the non-success response with the status
- info
added the optional property
to the response with the status - info
added the required property
to the response with the status - info
added the required property
to the response with the status
- warning