Value Clusters

Distinct current values among the filtered review set (typically one field), with counts and member items — drives identical-value cluster bulk-approve.

The value-clusters endpoint groups held review items by their current value. When a single field is held across many documents with the same value, those items form one cluster you can review once and approve together. This is the data behind a "approve all 40 documents where vendor_name is Meridian Energy AG" action: one decision instead of forty.

Filter to the set you want to cluster — typically a single field_key, optionally scoped by pipeline_id, schema_id, document_id, stage_id, trigger, reason, assignee, or age. Each returned cluster carries the distinct value, a count, and its member items (the document + field-key pairs), which you can hand straight to POST /v1/field-reviews/bulk-resolve.

Response