Create a taxonomy from a document selection or a cluster run (one gesture)
Changed onPromote a document selection (e.g. a lasso/cluster selection in the cluster visualization) into a NEW flat taxonomy in one call.
Creates, in order:
- a node collection mirroring the selection's vector index (same vector name, dimensions, and feature_uri — no re-embedding, no GPU work),
- a vector-search retriever over it,
- the flat taxonomy wired to both (input_mappings map an incoming document's stored embedding onto the retriever),
- the nodes, from one of two sources:
- documents + node_label: one node whose anchor vector is the centroid of the referenced documents' stored vectors;
- cluster_run ({cluster_id, run_id}): one node per cluster in that run, labeled with the cluster's label and anchored on its stored centroid, so a whole cluster run becomes a classifier in one call. The response's nodes lists every node created.
Documents enriched through the taxonomy afterwards are labeled with the nearest node's label. To add more nodes later, use POST /v1/taxonomies/{taxonomy_id}/nodes/from-documents.
Resources created before a failing step are cleaned up best-effort.
Request
- Base URL: https://api.mixpeek.com
- URL: https://api.mixpeek.com/v1/taxonomies/from-documents
- Auth: HTTP bearer and API key in header X-Namespace
Request body
Response
Successful Response
Changes
- 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
- info
added the new optional request property
- info
the request property
became optional - info
the request property
became optional - info
request property
list-of-types was widened by adding typesnullto media typeapplication/json - info
request property
list-of-types was widened by adding typesnullto media typeapplication/json - info
the
request property's minLength was decreased from1to0 - info
added the optional property
to the response with the status
- info