---
title: "Trigger Transformation Evaluations"
method: POST
path: "/v3/eval"
tags: ["Function Accuracy"]
---

# Trigger Transformation Evaluations

`POST /v3/eval`

**Queue evaluation jobs for a batch of transformations.**

Evaluations run asynchronously and score each transformation's output
against the function's schema for confidence, hallucination detection,
and relevance. Transformations must belong to events of a supported
type: `extract`, `transform`, `analyze`, or `join`.

Returns immediately with a summary of queued vs. skipped transformations
and per-transformation errors. Poll `GET /v3/eval/results` to retrieve
results once evaluations complete.

## Request body

- TriggerEvaluationsRequestV3 — Request to queue evaluation jobs for a batch of transformations. Evaluations assess a transformation's output against the function's schema-defined ground truth signals (confidence, hallucination detection, relevance). Each transformation must belong to an event of a supported type: `extract`, `transform`, `analyze`, or `join`.
  - `transformationIDs` string[], required — Transformation IDs to evaluate. Up to 100 per request.
  - `evaluationVersion` string — Optional evaluation version (e.g. `0.1.0-gemini`). When omitted the server's default evaluation version is used.

## Response `202`

The request has been accepted for processing, but processing has not yet completed.

- TriggerEvaluationsResponseV3 — Summary of the trigger call. Evaluations run asynchronously; use `GET /v3/eval/results` to poll for results.
  - `queued` integer, required — Number of evaluation jobs newly queued.
  - `skipped` integer, required — Number of transformations skipped because an evaluation job was already pending or already completed for them.
  - `errors` object — Map of transformation ID to human-readable error message for any transformations that could not be queued (e.g. not found, unsupported event type).

## Other responses

- `400` — The server could not understand the request due to invalid syntax.

---

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