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

# Create Evaluation

`POST /core/evaluations`

## Request

- Base URL: `https://api.anyreach.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.anyreach.ai/core/evaluations`
- Auth: HTTP bearer

Create an evaluation (a bundle of metrics + judge config).

## Headers

- `x-anyreach-org` string, nullable: Organization ID for user PATs (pat_ prefix tokens)

## Request body

- EvaluationCreateRequest: Schema for API requests to create a new evaluation (metric bundle). No `input`/`judge_config`: the judge is always Gemini Pro and the content to resolve is derived from the bundle's metrics' modalities.
  - `name` string, required
  - `description` string, nullable
  - `instructions` string, nullable
  - `metric_ids` string[], required
  - `transcription` object, nullable

## Response `200`

Successful Response

- Evaluation: Evaluation entity — a bundle of metrics (+ optional shared framing). Renamed from Scorecard: "scorecard" connotes a *score* (a rollup), which is deferred to the derived layer (PRD §13.1). Many evaluations may run on one conversation (compliance vs quality vs sales bundles). The judge is always Gemini Pro and the content needed is derived from the metrics' modalities — so there's no per-evaluation input/judge_config.
  - `id` string, required
  - `organization_id` string, required
  - `name` string, required
  - `description` string, nullable
  - `instructions` string, nullable
  - `metric_ids` string[], required
  - `transcription` object, nullable
  - `archived_at` string, date-time, nullable
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `created_by` string, nullable
  - `modified_by` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/anyreach/apis/anyreach-api.md) - [All operations](https://skmtc.dev/anyreach/apis/anyreach-api/llms.txt) - [OpenAPI document](https://skmtc.dev/anyreach/apis/anyreach-api/revisions/2eddf40c8c93?raw)