judges

List judges

Every judge in the environment, newest first. Each item bundles configuration, trigger rules, and rollups such as average score and total evaluations completed.

Required permission: judges.view.

get/v1/projects/{project_id}/judges

Request

  • Base URL: https://api.connic.co
  • URL: https://api.connic.co/v1/projects/{project_id}/judges
  • Auth: HTTP bearer

Path parameters

project_idstring uuid required

ID of the project the API key belongs to.

Query parameters

environment_idstring uuid required

Environment to list judges for

Response

Successful Response

idstring uuid required
project_idstring uuid required

Project the judge belongs to.

environment_idstring uuid required

Environment whose runs the judge evaluates.

namestring required
agent_namestring required

Agent whose runs the judge evaluates.

modelstring required

Model that scores runs.

system_promptstring required

Extra instructions for the scoring model.

include_agent_system_promptboolean required

Whether the evaluated agent's system prompt is included in the scoring context.

filter_expressionstring required

Expression a run must match to be evaluated automatically. Empty matches every run.

trigger_modestring required

automatic evaluates runs when they complete; manual evaluates only when triggered.

sample_ratenumber required

Share of matching runs evaluated automatically, from 0 to 1.

notification_thresholdnumber nullable

Average score share (0 to 1) below which a judge_score_low notification is sent. null when disabled.

notification_windowinteger nullable

Number of most recent evaluations averaged for notification_threshold. null averages all.

enabledboolean required

When false, runs are not evaluated automatically.

created_atstring date-time required
updated_atstring date-time required
avg_scorenumber nullable

Average overall score of completed evaluations. null before the first one.

avg_max_scorenumber nullable

Average maximum possible score of completed evaluations. null before the first one.

total_evaluatedinteger

Number of completed evaluations.

Changes

No recorded changes to this operation across all 2 revisions of this API.