/docs/api/clusters
Clusters API
Read and trigger cluster discovery. Each project's clusters are stored independently.
GET /v1/clusters
{
"clusters": [
{ "id": "clu_…", "label": "Incorrect tool selection", "size": 127, "color": "fail" },
{ "id": "clu_…", "label": "Shipping inquiries", "size": 89, "color": "ok" }
],
"computed_at": "2026-04-26T07:00:00Z"
}GET /v1/clusters/:id
Returns the cluster, representative traces, and the centroid embedding.
POST /v1/clusters/discover
Trigger an out-of-band cluster discovery run. Returns a job ID; poll for completion.
{ "window_hours": 168, "k_min": 4, "k_max": 16 }