---
title: "Create Evaluation"
method: POST
path: "/evaluations"
tags: ["Evaluations"]
---

# Create Evaluation

`POST /evaluations`

Creates a new comparison table document
Raises:
    HTTPException: _description_
Returns:
    _description_

## Request body

- NewEvaluation
  - `app_id` string, required
  - `revisions_ids` string[], required
  - `evaluators_configs` string[], required
  - `testset_id` string, required
  - `rate_limit` LLMRunRateLimit, required
    - `batch_size` integer, required
    - `max_retries` integer, required
    - `retry_delay` integer, required
    - `delay_between_batches` integer, required
  - `correct_answer_column` string, nullable

## Response `200`

Successful Response

- Evaluation[]
  - `id` string, required
  - `app_id` string, required
  - `project_id` string, required
  - `variant_ids` string[], required
  - `variant_names` string[], required
  - `variant_revision_ids` string[], required
  - `revisions` string[], required
  - `testset_id` string, nullable
  - `testset_name` string, nullable
  - `status` Result, required
    - `type` string, required
    - `value` unknown
    - `error` Error
      - `message` string, required
      - `stacktrace` string, nullable
  - `aggregated_results` AggregatedResult[], required
    - `evaluator_config` union, required
      - EvaluatorConfig
        - `id` string, required
        - `name` string, required
        - `project_id` string, required
        - `evaluator_key` string, required
        - `settings_values` object, nullable
        - `created_at` string, required
        - `updated_at` string, required
      - object
    - `result` Result, required
      - `type` string, required
      - `value` unknown
      - `error` Error
        - `message` string, required
        - `stacktrace` string, nullable
  - `average_cost` Result
    - `type` string, required
    - `value` unknown
    - `error` Error
      - `message` string, required
      - `stacktrace` string, nullable
  - `total_cost` Result
    - `type` string, required
    - `value` unknown
    - `error` Error
      - `message` string, required
      - `stacktrace` string, nullable
  - `average_latency` Result
    - `type` string, required
    - `value` unknown
    - `error` Error
      - `message` string, required
      - `stacktrace` string, nullable
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `422` — Validation Error

## Changes

- **2025-06-27** `e3e84db47198` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/agenta-ai/apis/agenta-api/changes/evaluations/post.md)

---

[API](https://skmtc.dev/agenta-ai/apis/agenta-api.md) · [All operations](https://skmtc.dev/agenta-ai/apis/agenta-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/agenta-ai/agenta-api/revisions/e3e84db47198/schema)