---
title: "Record an enrichment eval-run scorecard"
method: POST
path: "/experimental/enrichment-eval-runs"
tags: ["Enrichment Eval Runs"]
---

# Record an enrichment eval-run scorecard

`POST /experimental/enrichment-eval-runs`

Stores one scorecard emitted by the gold plugin's scorer. The body is the scorecard verbatim; the run is stored as a single row and is queryable by `extractorCommit`, `goldVersion`, and `model`.

## Headers

- `Authorization` string

## Request body

- object
  - `gold_version` string, required — Semver of the gold set the run was scored against. Free text, since the gold set is versioned outside this database, so no version is resolved or validated against a stored record.
  - `config` object, required
    - `model` string, required
    - `promptVersion` string, required
    - `maxRounds` integer, required
    - `maxStepsPerAgent` integer, required
    - `runs` integer, required
  - `runs` integer, required — Number of repeats the aggregate metrics were computed over. Always matches `config.runs`.
  - `aggregate` object, required
    - `item_recall` union, required
      - object
        - `mean` number, required
        - `stddev` number, required
        - `n` integer, required
      - object
        - `mean` unknown, required
        - `stddev` unknown, required
        - `n` 0, required
    - `item_precision` union, required
      - object
        - `mean` number, required
        - `stddev` number, required
        - `n` integer, required
      - object
        - `mean` unknown, required
        - `stddev` unknown, required
        - `n` 0, required
    - `loc_coverage` union, required
      - object
        - `mean` number, required
        - `stddev` number, required
        - `n` integer, required
      - object
        - `mean` unknown, required
        - `stddev` unknown, required
        - `n` 0, required
    - `overflag_excluded` union, required
      - object
        - `mean` number, required
        - `stddev` number, required
        - `n` integer, required
      - object
        - `mean` unknown, required
        - `stddev` unknown, required
        - `n` 0, required
    - `overflag_novel` union, required
      - object
        - `mean` number, required
        - `stddev` number, required
        - `n` integer, required
      - object
        - `mean` unknown, required
        - `stddev` unknown, required
        - `n` 0, required
  - `per_case` object[], required
    - `plugin_id` string, required
    - `code` string, required
    - `metrics` object, required
      - `item_recall` union, required
        - object
          - `mean` number, required
          - `stddev` number, required
          - `n` integer, required
        - object
          - `mean` unknown, required
          - `stddev` unknown, required
          - `n` 0, required
      - `item_precision` union, required
        - object
          - `mean` number, required
          - `stddev` number, required
          - `n` integer, required
        - object
          - `mean` unknown, required
          - `stddev` unknown, required
          - `n` 0, required
      - `loc_coverage` union, required
        - object
          - `mean` number, required
          - `stddev` number, required
          - `n` integer, required
        - object
          - `mean` unknown, required
          - `stddev` unknown, required
          - `n` 0, required
      - `overflag_excluded` union, required
        - object
          - `mean` number, required
          - `stddev` number, required
          - `n` integer, required
        - object
          - `mean` unknown, required
          - `stddev` unknown, required
          - `n` 0, required
      - `overflag_novel` union, required
        - object
          - `mean` number, required
          - `stddev` number, required
          - `n` integer, required
        - object
          - `mean` unknown, required
          - `stddev` unknown, required
          - `n` 0, required
  - `extractorCommit` string, required — Git sha of the extractor revision the run scored.

## Response `201`

Default Response

- object
  - `links` object, required
    - `self` string, uri, required
  - `data` object, required
    - `id` string, uuid, required
    - `type` 'enrichment-eval-run', required
    - `attributes` object, required
      - `extractorCommit` string, required
      - `goldVersion` string, required
      - `model` string, required
      - `promptVersion` string, required
      - `config` object, required
        - `model` string, required
        - `promptVersion` string, required
        - `maxRounds` integer, required
        - `maxStepsPerAgent` integer, required
        - `runs` integer, required
      - `metrics` object, required
        - `item_recall` union, required
          - object
            - `mean` number, required
            - `stddev` number, required
            - `n` integer, required
          - object
            - `mean` unknown, required
            - `stddev` unknown, required
            - `n` 0, required
        - `item_precision` union, required
          - object
            - `mean` number, required
            - `stddev` number, required
            - `n` integer, required
          - object
            - `mean` unknown, required
            - `stddev` unknown, required
            - `n` 0, required
        - `loc_coverage` union, required
          - object
            - `mean` number, required
            - `stddev` number, required
            - `n` integer, required
          - object
            - `mean` unknown, required
            - `stddev` unknown, required
            - `n` 0, required
        - `overflag_excluded` union, required
          - object
            - `mean` number, required
            - `stddev` number, required
            - `n` integer, required
          - object
            - `mean` unknown, required
            - `stddev` unknown, required
            - `n` 0, required
        - `overflag_novel` union, required
          - object
            - `mean` number, required
            - `stddev` number, required
            - `n` integer, required
          - object
            - `mean` unknown, required
            - `stddev` unknown, required
            - `n` 0, required
      - `perCase` object[], required
        - `plugin_id` string, required
        - `code` string, required
        - `metrics` object, required
          - `item_recall` union, required
            - object
              - …
            - object
              - …
          - `item_precision` union, required
            - object
              - …
            - object
              - …
          - `loc_coverage` union, required
            - object
              - …
            - object
              - …
          - `overflag_excluded` union, required
            - object
              - …
            - object
              - …
          - `overflag_novel` union, required
            - object
              - …
            - object
              - …
      - `createdAt` string, date-time, required

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.net/tessl/apis/tessl-api.md) · [All operations](https://skmtc.net/tessl/apis/tessl-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tessl/tessl-api/revisions/a3e84124ece4/schema)