Skip to main content
POST
Override a judge verdict
Records your judgement of one verdict, as the Console’s “Disagree with this Judge” does. overrideAction is agree, or how you disagree: disagree_overruled, disagree_modified or partial_agreement. rationale must be at least 20 characters after trimming and is stored as sent. perCriterionAdjustments optionally gives the score you would give each criterion, by criterion id (printable ASCII without spaces, not starting with $ or _), at most 50. Judge agreement rates are computed from overrides. Overriding a verdict again replaces its earlier override. The answer is 200 with data.override: {verdictId, overrideAction, overriddenAt}. The verdict then reads back through List judge verdicts with hasOperatorOverride and operatorOverrideAction; who overrode it and why are never returned. The body is strict: an unknown field, a missing field, an unknown overrideAction or a short rationale is 400. An empty, malformed or unknown verdictId answers 404 resource_missing “Verdict not found”, and so does a verdict on a PERSONAL agent or on an agent that no longer exists, which the verdict reads leave out. Needs judges:use 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 records the override again. 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:use 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 verdict back with List judge verdicts; 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

verdictId
string
required

The verdict's id, from listVerdicts or getAdmission.

Body

application/json
overrideAction
enum<string>
required

agree, or how you disagree: disagree_overruled, disagree_modified or partial_agreement.

Available options:
agree,
disagree_overruled,
disagree_modified,
partial_agreement
rationale
string
required

Why: at least 20 characters after trimming. Stored as sent.

Minimum string length: 20
perCriterionAdjustments
object

The score you would give each criterion, by criterion id; at most 50.

Response

The recorded override

data
object
required
meta
object
required