---
title: "Run Eval"
method: POST
path: "/v1/evals/{name}"
tags: ["Evaluations"]
---

# Run Eval

`POST /v1/evals/{name}`

Evaluate a model against a eval spice specification

## Path parameters

- `name` string, required

## Request body

- RunEval — Input parameters to start an evaluation run for a given model.
  - `model` string, required

## Response `200`

Evaluation run successfully

- EvalRunResponse — Represents the response for an evaluation run
  - `dataset` string, required — The name of the dataset used for the evaluation
  - `error_message` string, nullable — The error message if the evaluation failed, otherwise `None`
  - `metrics` object, required — A map of metric names to their corresponding values
  - `model` string, required — The model used for the evaluation
  - `primary_key` string, required — Unique identifier for the evaluation run
  - `scorers` string[], required — List of scorers used in the evaluation
  - `status` string, required — The status of the evaluation (e.g., "completed", "failed", etc.)
  - `time_column` string, required — Timestamp indicating when the evaluation was created or run

## Changes

- **2025-03-18** `dd94571fef79` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/spiceai/apis/runtime/changes/v1/evals/:name/post.md)

---

[API](https://skmtc.dev/spiceai/apis/runtime.md) · [All operations](https://skmtc.dev/spiceai/apis/runtime/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/spiceai/runtime/revisions/dd94571fef79/schema)