---
title: "Run Batch Evaluation"
method: POST
path: "/evals/evaluate"
tags: ["EVALS"]
deprecated: true
---

# Run Batch Evaluation

`POST /evals/evaluate`

> **Deprecated.**

Run evaluations for multiple test cases with all selected agents and criteria.

Each test case is evaluated with ALL selected agents available for use.
This is the main evaluation endpoint that accepts:
- List of agents with full configuration (all agents are available for each test case)
- List of test case IDs (reference to pool)
- List of criteria with complete data

Returns a job ID and status information.

## Query parameters

- `navigationSource` string, nullable

## Request body

- BatchEvaluationRequest — Request for running evaluations across agents, test cases, and criteria This request contains agent and criteria data, with test case IDs for reference. - Agents: Full configuration (both local and backend agents) - Test Cases: IDs only (stored in pool, prevents duplication) - Criteria: Full data (varies per run, stored in results for audit trail) - Context: DataMate and Knowledge Base IDs (global and per-agent overrides)
  - `agents` AppSchemasEvalsAgentConfig[], required
    - `id` string, required
    - `name` string, required
    - `description` string, required
    - `prompt` string, required
    - `model` string, required
    - `is_local` boolean
  - `test_case_ids` string[], required
  - `criteria` CriterionResponse[], required
    - `id` string, required
    - `name` string, required
    - `description` string, required
    - `created_at` string, required
    - `updated_at` string, required
    - `created_by` string, nullable
    - `updated_by` string, nullable
    - `tenant` string
  - `global_context` GlobalContext — Global context applied to all agents in evaluation
    - `datamate_ids` string[]
    - `knowledge_base_ids` integer[]
  - `agent_context_overrides` AgentContextOverride[]
    - `agent_id` string, required
    - `datamate_ids` string[]
    - `knowledge_base_ids` integer[]
  - `run_name` string, nullable
  - `session_id` string, nullable

## Response `200`

Successful Response

- EvaluationJobResponse — Response for batch evaluation submission
  - `job_id` string, required
  - `message` string, required
  - `total_evaluations` integer, required
  - `agents_count` integer, required
  - `test_cases_count` integer, required
  - `criteria_count` integer, required
  - `status` string

## 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)