---
title: "Run Eval"
method: POST
path: "/evals/run"
tags: ["EVALS"]
---

# Run Eval

`POST /evals/run`

Run an evaluation for a test case.
This simulates the conversation by calling the /ask endpoint and evaluates responses.

## Query parameters

- `navigationSource` string, nullable

## Request body

- RunEvalRequest
  - `test_case_id` string, required
  - `session_id` string, nullable

## Response `200`

Successful Response

- EvalResultResponse
  - `id` string, required
  - `test_case_id` string, nullable
  - `test_case_name` string, required
  - `test_case_description` string, nullable
  - `test_case_tags` string[], nullable
  - `status` string, nullable
  - `overall_score` number, nullable
  - `judge_errors` integer, nullable
  - `judge_model` string, nullable
  - `turn_results` TurnResult[], required
    - `turn_number` integer, required
    - `user_message` string, required
    - `expected_ai_response` string, required
    - `actual_ai_response` string, required
    - `evaluation` object, required
    - `intermediate_messages` string, nullable
  - `created_at` string, required
  - `session_id` string, nullable
  - `run_name` string, nullable
  - `tenant` string
  - `run_tenant` string, nullable
  - `trace_id` string, nullable
  - `datamate_ids_used` string[], nullable
  - `knowledge_base_ids_used` integer[], nullable
  - `tools_invoked` object, nullable
  - `knowledge_bases_queried` integer[], nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/myaltimate/apis/fastapi.md) · [All operations](https://skmtc.net/myaltimate/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/myaltimate/fastapi/versions/aab3fe5c9f05/schema)