v20

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-035471202.8 KB
Eval runs

Get an iteration trace

Full trace envelope for one iteration: conversation messages, expected-vs-actual tool call analysis, and spans. The shape is rich and may evolve — treat it as an open document. Returns 404 with details.reason: "TRACE_NOT_AVAILABLE" when the iteration finished without a stored trace.

get/projects/{projectId}/eval-runs/{runId}/iterations/{iterationId}/trace

Path parameters

projectIdstring required

ID of the hosted project that contains the server.

runIdstring required

Eval run ID, as returned by POST /eval-runs.

iterationIdstring required

Iteration ID, as returned by the run's iterations list.

Response

The trace envelope.

object required

Trace document: messages, prompts (per-prompt expected/actual tool-call analysis), spans, and more.