Skip to main content
GET
List judge drift alerts
Without judgeId, returns the active drift alerts of every judge as data.alerts, newest first, a page at a time. With judgeId, returns that judge’s alerts in status (active, acknowledged or resolved; default active), newest first, and a judge that does not exist answers 404 resource_missing “Judge not found”. status without judgeId is 400 bad_request: the list across judges is the active alerts only. limit is 1-200, default 50; a larger value is 400 too_big. While meta.hasMore is true, pass meta.nextCursor as cursor (with the same other parameters) for the next page; a cursor sent with another route, other parameters or another credential, or altered, is 400. The list never answers meta.partial. signal is one of agreement_rate_warning, agreement_rate_critical, verdict_distribution_skew, cost_regression or zero_dispatches; treat an unknown signal as new rather than as an error. Needs platform:read at the platform scope: a grant that covers only some org units receives 403.

Authorizations

Authorization
string
header
required

An External App: the JWT it obtains from POST /oauth/token with OAuth2 client_credentials. Pass as Authorization: Bearer <jwt>. An app's static companion key also authenticates as the app, but is deprecated and is not protected by Idempotency-Key.

Query Parameters

judgeId
string

Only this judge's alerts.

Minimum string length: 1
status
enum<string>
default:active

With judgeId: alerts in this state. Default active.

Available options:
active,
acknowledged,
resolved
limit
integer
default:50

Items per page, 1 to 200 (default 50); a larger value is a 400 too_big. A page may hold fewer items than limit while meta.hasMore is true; continue with meta.nextCursor.

Required range: 1 <= x <= 200
cursor
string

The previous page's meta.nextCursor; any other value is 400.

Minimum string length: 1

Response

The drift alerts

data
object
required
meta
object
required

A list page's continuation. While hasMore is true, nextCursor is a string: pass it as cursor for the next page. hasMore: false ends the list; with truncated: true, more exist past what this list reads, and no cursor reaches them.