Skip to main content
POST
Create Session Eval Run

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Create a filter-based session eval run.

metrics
string[]
required

Session metric names (e.g. ['agent_reliability']).

Minimum array length: 1
name
string | null

Human-readable label.

filters
SessionEvalRunFilters · object

Filters for session-level evaluation runs.

sampling_rate
number
default:1

Fraction of sessions to evaluate.

Required range: 0 <= x <= 1
model
string | null

LLM model override for judge calls.

signal_weights
Signal Weights · object | null

Override default signal weights.

Response

Successful Response

Full eval run representation used by both list and detail endpoints.

id
string<uuid>
required
name
string | null
required
status
enum<string>
required

Lifecycle status of an evaluation job.

Available options:
PENDING,
RUNNING,
COMPLETED,
FAILED
metric_names
string[]
required
total_traces
integer
required
evaluated_count
integer
required
failed_count
integer
required
created_at
string
required
completed_at
string | null
required
project_id
string<uuid>
required
target_type
string
required
filters
Filters · object
required
sampling_rate
number
required
model
string | null
required
monitor_id
string<uuid> | null
required
error_message
string | null
required