Skip to main content
POST
Score one result

Authorizations

Authorization
string
header
required

An API key, sent as Authorization: Bearer stfy_live_…. See Authentication for how to get one and which scopes it needs.

Body

application/json
judged_by
string
required

Who formed this verdict. Scoring with a different name adds a verdict rather than replacing the first, so two judges on one run stay comparable.

Required string length: 1 - 100
result_id
string
required

The result being scored, from GET /v1/evaluations/runs/{run_id}/results.

scores
Scores · object
required

The verdict, in whatever shape the judge uses. passed and score_1_5 are read for the run's totals; everything else is kept as sent.

passed
boolean | null

Defaults to scores.passed.

reason
string | null

Defaults to scores.reason.

Response

200 - application/json

Successful Response

case_id
string
required
id
string
required
defer_reason
string | null
deferred
boolean
default:false

The worker handed the thread to a human instead of answering. Reactive runs only.

error
string | null

The session's own failure. Distinct from a failing verdict: this case produced nothing to judge.

judged_by
string | null
output
Output · object | null

What the worker did, in the shape its mode produces. Proactive: acted, any drafts it composed, and its own summary. Reactive: answered, the reply text, the two ways a reply can be withheld — held_by_guardrail (the platform stopped it) and no_reply (the worker judged the thread needed none) — and loop_in: the part of the ask handed to a person while the reply goes out (note for them, a follow-up draft they finish, and the guardrail's flag on it), null when nothing was left for a person. A loop_in is a hand-off as much as deferred is. Results recorded before loop-ins were (16 Nov 2026) have no loop_in key: there, its absence does not mean nobody was looped in.

passed
boolean | null

null means nobody has scored this one yet.

reason
string | null
scores
Scores · object | null
tool_calls
Tool Calls · object[] | null

What it read to get there — the evidence a verdict about grounding has to be checked against.

trace_id
string | null
turns
integer | null