v1

latestOpenAPI 3.1.02026-07-175793186.0 KB
evaluations

Start evaluation run

Kick off a GenAI evaluation run on MLflow traces. Returns a run_id that can be used to retrieve the full report via GET /evaluations/{run_id}.

post/api/v1/evaluations

Request body

trace_idsstring[] nullable

Optional list of specific trace IDs to evaluate (max 100).

limitinteger nullable

Optional maximum number of traces to evaluate (1-1000).

from_last_daysinteger

Number of days to look back for traces (0-365, default: 1).

Response

Successful Response

run_idstring required

Unique identifier for this evaluation run.

statusstring

Lifecycle status of the run: pending (queued/just-started), running (background task executing), completed (report available), or failed (evaluation error).