# Build a test set from judgments POST /v1/eval-suites/{suiteId}/versions/from-judgments ```sh curl --request POST \ --url https://example.com/v1/eval-suites/example/versions/from-judgments \ --header 'Authorization: Bearer ' \ --header 'Content-Type: application/json' \ --data '{ "version": "example", "projectId": "example", "agentId": "example", "agentVersion": "example", "flowId": "example", "since": "2026-04-15T12:00:00Z", "until": "2026-04-15T12:00:00Z", "judgeClassIds": [ "example" ], "minJudgments": 1, "segments": [ { "key": "example", "value": "example" } ], "description": "example" }' ``` Publishes a `judged` eval suite version whose cases are copies of judged runs of one agent (optionally one version) or flow, newest first, at most 1000. Each case holds the run’s input, what the turn read (`context`), the judged output, and each item’s judgments summed up: yes and no counts, the weight behind yes and behind all judgments (an unclassified judgment counts 1), and the reasons. `judgeClassIds` counts only judgments of those classes; `minJudgments` leaves out runs with fewer; `segments` keeps only runs started in that segment path or below it. Needs `admin` on the project. ## Authorizations - **[bearerAuth](https://docs.kindgi.com/v0.1.8/reference/api.md#bearerauth)** ## Parameters ### Path Parameters **suiteId** required string \>= 1 characters EvalSuiteId — stable string chosen by the caller (e.g. `acme.drafting-accuracy`). ### Header Parameters **Idempotency-Key** string \>= 1 characters Caller-supplied idempotency key, scoped to the caller: the same key from someone else in the tenant is their own request (from 0.1.5). Retries with the same key return the original response byte-identical (per `docs/API-ROUTE-CONVENTIONS.md` §3.1). A retry sent while the first request still runs is answered `409 idempotency-key-in-flight` with `Retry-After`, on a runtime whose store holds keys (from 0.1.5); retry after it, and you get the first request’s answer. An answer that carries a secret (a new API key or public run token, a session token, a generated signing secret) isn’t kept: a retry gets `409 idempotency-key-replay-withheld`, with the first request’s status and when it succeeded (from 0.1.5). ## Request Bodyrequired application/json Name the agent (`agentId`) or the flow (`flowId`) whose judged runs to use. object **version** required Semver version to publish, e.g. `1.0.0`. string **projectId** required string \>= 1 characters **agentId** string \>= 1 characters **agentVersion** Needs `agentId`. string \>= 1 characters **flowId** string \>= 1 characters **since** Runs first judged at or after this time. string format: date-time **until** Runs first judged before this time. string format: date-time **judgeClassIds** Count only judgments recorded under these judge classes. Array\ **minJudgments** Leave out runs with fewer counted judgments. Default 1. integer \>= 1 **segments** Only runs started in this segment path or below it, coarse to fine (e.g. `company=acme`). A run judged before its segments were recorded with its judgments is in no segment, so it’s left out. Array\