---
title: "Apply Cluster Enrichment"
method: POST
path: "/v1/clusters/enrich"
tags: ["Clusters"]
---

# Apply Cluster Enrichment

`POST /v1/clusters/enrich`

Apply clustering enrichments to a collection via engine.

## Request body

- ApplyClusterEnrichmentRequest — Request to apply clustering enrichment to a collection. Supports applying multiple clustering results in one request via `clustering_ids`. For backward compatibility, a single `clustering_id` is also accepted and up-converted.
  - `clustering_ids` string[], required — Clustering result IDs to apply
  - `source_collection_id` string, required — Collection to enrich
  - `target_collection_id` string, nullable — Target collection to write enriched docs to
  - `batch_size` integer — Batch size for processing
  - `parallelism` integer — Parallel workers

## Response `200`

Successful Response

- ClusteringEnrichmentResponse — Response after applying clustering enrichment.
  - `processed` integer, required — Number of processed points
  - `enriched` integer, required — Number of enriched points
  - `failed` integer, required — Number of failed points
  - `batches` integer, required — Batches processed

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `422` — Validation Error
- `500` — Internal Server Error

---

[API](https://skmtc.net/mixpeek/apis/mixpeek-api.md) · [All operations](https://skmtc.net/mixpeek/apis/mixpeek-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mixpeek/mixpeek-api/revisions/220a3b263fda/schema)