# Overview

## Eval suites

Evaluation suite catalog (list, get, versions, publish, unregister) — part of the admin control plane. Full versioned CRUD, mirrors `policies` 1:1. Registry-only: eval-run execution + per-kind grader dispatch live on the `eval-runs` tag. `evalKind` selects the shape of `spec` — closed enum, extended additively (`accuracy`, `pairwise`, `regression`, `human-review`, `benchmark`, `custom`, `judged`). The cases of a `judged` suite are copies of judged runs built from judgments (`POST .../versions/from-judgments`, listed at `GET .../versions/{version}/cases`; `EvalCaseStoreBinding`). Runs against these suites are started through the `eval-runs` tag. Caller-plugged via `EvalSuiteRegistryBinding`.

## Operations

GET

[/v1/eval-suites](https://docs.kindgi.com/v0.1.10/reference/api/operations/evalsuiteslist.md)

POST

[/v1/eval-suites](https://docs.kindgi.com/v0.1.10/reference/api/operations/evalsuitespublish.md)

GET

[/v1/eval-suites/{suiteId}](https://docs.kindgi.com/v0.1.10/reference/api/operations/evalsuitesget.md)

GET

[/v1/eval-suites/{suiteId}/versions](https://docs.kindgi.com/v0.1.10/reference/api/operations/evalsuitesversionslist.md)

GET

[/v1/eval-suites/{suiteId}/versions/{version}](https://docs.kindgi.com/v0.1.10/reference/api/operations/evalsuitesversionsget.md)

POST

[/v1/eval-suites/{suiteId}/versions/from-judgments](https://docs.kindgi.com/v0.1.10/reference/api/operations/evalsuitesbuildfromjudgments.md)

GET

[/v1/eval-suites/{suiteId}/versions/{version}/cases](https://docs.kindgi.com/v0.1.10/reference/api/operations/evalsuiteslistcases.md)

POST

[/v1/eval-suites/{suiteId}/versions/{version}/unregister](https://docs.kindgi.com/v0.1.10/reference/api/operations/evalsuitesversionsunregister.md)

POST

[/v1/eval-suites/{suiteId}/versions/{version}/reinstate](https://docs.kindgi.com/v0.1.10/reference/api/operations/evalsuitesreinstateversion.md)