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

# Batch Run Eval

`POST /evals/batch-run`

> **Deprecated.**

Run evaluations for multiple test cases.
Allows selecting specific test cases and naming the run.

## Query parameters

- `navigationSource` string, nullable

## Request body

- BatchRunEvalRequest
  - `test_case_ids` string[], required
  - `run_name` string, nullable
  - `session_id` string, nullable

## Response `200`

Successful Response

- BatchRunResponse
  - `run_name` string, nullable
  - `total` integer, required
  - `successful` integer, required
  - `failed` integer, required
  - `results` EvalResultResponse[], required
    - `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

## Changes

- **2026-08-08** `103580dad816` — 2 breaking, 5 info
  - the response property `results/items/overall_score` became optional for the status `200`
  - response property `results/items/overall_score` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - added the optional property `results/items/judge_errors` to the response with the `200` status
  - added the optional property `results/items/judge_model` to the response with the `200` status
  - …3 more

[Change history](https://skmtc.dev/myaltimate/apis/fastapi/changes/evals/batch-run/post.md)

---

[API](https://skmtc.dev/myaltimate/apis/fastapi.md) · [All operations](https://skmtc.dev/myaltimate/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/myaltimate/fastapi/revisions/124adbd00d3f/schema)