---
title: "Report evaluation scores for a run"
method: POST
path: "/agent/runs/{runId}/scores"
tags: ["agent"]
---

# Report evaluation scores for a run

`POST /agent/runs/{runId}/scores`

Report one or more evaluation verdicts for a run. Called by the judge run
that was dispatched to score this run, authenticating with that judge
run's API key. Each verdict is processed independently: the response
reports per-verdict acceptance, and a rejected verdict does not block the
others. Reporting a subset of the run's evaluations is valid.

## Path parameters

- `runId` string, required

## Request body

- ReportRunScoresRequest
  - `results` ReportedRunScore[], required
    - `scorer_id` integer, required — The evaluation this verdict belongs to
    - `classification` string — The chosen classification. Must exactly match one of the allowed label values captured when the evaluation was dispatched. Ignored when `failed` is true.
    - `reason` string — Optional judge reasoning. Stored outside the database and truncated beyond 8KB; a storage failure does not reject the verdict.
    - `failed` boolean — True when the judge could not evaluate this evaluation. Failed verdicts are accepted but record no score.

## Response `200`

Every reported verdict was accepted

- ReportRunScoresResponse
  - `results` ReportedRunScoreOutcome[], required
    - `scorer_id` integer, required — The evaluation this outcome belongs to
    - `status` string, required — Whether the verdict was recorded: "accepted" or "rejected"
    - `error` string — Why the verdict was rejected; absent when accepted

## Other responses

- `206` — The request was well-formed but at least one verdict was rejected; inspect each result's status and error before deciding whether to resubmit
- `400` — Malformed request body
- `401` — Authentication required
- `500` — Internal server error

## Changes

- **2026-08-15** `a0daf9e59774` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/warp/apis/oz-agent-api/changes/agent/runs/:runId/scores/post.md)

---

[API](https://skmtc.dev/warp/apis/oz-agent-api.md) · [All operations](https://skmtc.dev/warp/apis/oz-agent-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/warp/oz-agent-api/revisions/a0daf9e59774/schema)