Skip to main content
GET
List failure clusters

Authorizations

Authorization
string
header
required

Your workspace API key, e.g. sk_sovereign_..., sent as Authorization: Bearer <key>.

Query Parameters

window_days
integer

Look-back window in days, integer 1..90.

force
boolean

Pass the literal "true" to bypass the per-workspace one-hour cache and re-cluster now.

Response

{window_days, generated_at, cached (true when served from the hourly cache), criteria:[{criterion_id, criterion_name, failures (online FAILs + pending suspects, deduped), without_reason (failures with no stored rationale — counted, never clustered), clusters:[{name, count, share (of this criterion's clustered failures), request_ids, example (one representative rationale verbatim)}]}]}. Cache-Control: no-store.

The response is of type object.