Skip to main content
POST
Trigger an evaluation run

Authorizations

Authorization
string
header
required

SDK API key (tl_...) or Clerk session JWT

Body

application/json
trace_id
string<uuid>
required
evaluator_type
enum<string>
required
Available options:
llm,
rule
metric_name
string
required
config
object

Evaluator-specific configuration. Free-form for forward compatibility; recognised keys are documented below. Unknown keys are ignored.

Response

Eval queued

eval_id
string<uuid>
required
status
enum<string>
required
Available options:
pending,
running,
complete,
failed