---
title: "Upload Eval Run"
method: POST
path: "/api/evals/runs"
tags: ["evals"]
---

# Upload Eval Run

`POST /api/evals/runs`

## Request body

- EvalRunUploadRequest
  - `project_id` string, required
  - `suite_name` string, required
  - `environment_reference` string, required
  - `model` string, nullable
  - `status` 'completed' | 'failed'
  - `error` string, nullable
  - `started_at` string, date-time, nullable
  - `metadata` object, nullable
  - `cases` EvalCasePayload[]
    - `case_id` string, nullable
    - `input` string, nullable
    - `expected` string, nullable
    - `actual` string, nullable
    - `score` number, nullable
    - `success` boolean, nullable
    - `reason` string, nullable
    - `error` string, nullable
    - `metrics` object, nullable
    - `latency_ms` integer, nullable
    - `total_tokens` integer, nullable

## Response `200`

Successful Response

- EvalRunUploadResponse
  - `ok` boolean
  - `eval_run_id` string, required
  - `total_cases` integer, required
  - `passed_cases` integer, required
  - `graded_cases` integer, required
  - `errored_cases` integer
  - `mean_score` number, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/freesolo/apis/platform-backend.md) · [All operations](https://skmtc.dev/freesolo/apis/platform-backend/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/freesolo/platform-backend/revisions/5626e92675af/schema)