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
Cluster ID or name
Response
Successful Response
Cluster metadata stored in MongoDB.
Collections to cluster together
1
Optional human-friendly name for the clustering job
Vector or attribute clustering
vector
, attribute
Required when cluster_type is 'vector' Configuration for vector-based clustering.
Required when cluster_type is 'attribute' Configuration for attribute-based clustering.
Configuration for LLM-based cluster labeling
Unique cluster identifier
S3 path to parquet files with cluster data
S3 key to members.parquet (if saved)
Number of clusters found
Clustering quality metrics Basic clustering quality metrics.
Clustering job status
PENDING
, IN_PROGRESS
, PROCESSING
, COMPLETED
, FAILED
, CANCELED
, UNKNOWN
, SKIPPED
, DRAFT
Associated task ID for clustering job
When the cluster was created
When the cluster was last updated