Skip to main content
POST
Promote a judge
Moves a provisional judge to approved after re-checking its latest 30-day metrics: at least 100 dispatches and an agreement rate of at least 0.85. The answer is 200 with {judgeId, tier, changed}. A judge that is already approved answers changed: false, and nothing is written. note (at most 2,000 characters) is recorded in the audit event. A refusal is 409 and names why: the judge is deprecated (invalid_state; demote it to provisional first), or it has no 30-day metrics yet or a threshold is not met (conflict), with the threshold and the judge’s value. The body is strict: an unknown field is 400. A judgeId that names no judge answers 404 resource_missing “Judge not found”. Needs judges:manage at the platform scope: a grant that covers only some org units receives 403, and nothing is written. A Personal key acts as its owner; an External App or platform key is recorded as itself, with who gave its grant (see Who acted). Without a key, a repeat answers changed: false. Send an Idempotency-Key to make a retry safe: the same key and body within 24 hours returns the recorded 200 only while you still hold judges:manage at the platform scope; otherwise 409 idempotency_result_unavailable, and the write never runs twice. The same key with a different body is 422. If an outcome is unknown, repeat with the same key or read the judge with Get judge; never retry under a new key.

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.

Headers

Idempotency-Key
string

Optional logical intent key. A same-key retry within 24 hours returns the recorded result without writing again.

Required string length: 1 - 255

Path Parameters

judgeId
string
required

The judge's id.

Body

application/json
note
string

Recorded in the audit event; at most 2000 characters.

Maximum string length: 2000

Response

The judge's tier

data
object
required
meta
object
required