Skip to main content
POST
Python

Authorizations

Authorization
string
header
required

API Key authentication. Format: "Bearer YOUR_API_KEY"

Path Parameters

judge_id
string<uuid>
required

Body

application/json

The content to grade. Provide either messages (with the candidate reply in output) or a plain input/output pair — messages and input are mutually exclusive, and at least one of messages/input/output is required.

messages
object[] | null

Chat transcript in the standard role/content shape (the messages sent to your model). Content may be a string or a list of content blocks; inline files ride as base64 data: URIs in file blocks.

input
any | null

Plain input (string or JSON) — alternative to messages.

output
any | null

The candidate output to grade (string or message object).

name
string | null

Name for this interaction (shown to the judge as context).

generation_model
string | null

The model that produced the content (context for the judge — not the judge model).

metadata
object | null

Free-form context shown to the judge (rendered as the interaction's trace metadata).

model_override
string | null

Normally omitted — the judge already pins its grading model, and every evaluation uses it by default. Set this only to deliberately grade with a different judge model for this one call (public judge-model names; append -thinking for extended reasoning).

Response

Verdict produced

id
string<uuid>
judge_id
string<uuid>
judge_version
integer | null

Version number of the judge version that graded this content.

source
enum<string>
Available options:
api,
monitor,
ui
status
enum<string>
Available options:
succeeded,
failed
model
string

The judge model used.

verdict
object | null

Null when status is failed.

error
string | null
latency_ms
integer | null
created_at
string<date-time>