Skip to content
Docs
GitHub

Get a single observer

Preview

Inspect agent quality, health, observers, semantic reports and notifications.

Public APIEverruns Cloud and self-hosted Platform

GET/v1/observers/{observer_id}

See authentication for credentials and permissions.

observer_id
required
string

Prefixed public identifier

Responses

200Success

Success

Media typeapplication/json

An observer: online scoring config over production sessions.

object
alert
One of:

Pass-rate alert, when set.

object
min_pass_rate
required

Pass rate (0.0–1.0) under which the alert opens.

number format: double
min_scored

Scores the window needs before the alert can open. Defaults to 20.

integer format: int32
window_hours

Window the rate is measured over, in hours (1–168). Defaults to 24.

integer format: int32
archived_at
string | null format: date-time
created_at
required
string format: date-time
description

Optional description.

string | null
id
required

External identifier (observer_<32-hex>). Shown as “id” in API.

string
match

Which sessions to score.

object
agent_ids

Match sessions running any of these agents.

Array<string> | null
harness_ids

Match sessions on any of these harnesses.

Array<string> | null
session_tags

Match sessions carrying any of these tags.

Array<string> | null
name
required

Display name.

string
sampling_rate
required

Fraction of matching turns to score (0.0–1.0), applied after match.

number format: double
scorers
required

Scoring rules.

Array

One scorer inside an observer. key names the score series in listings and future dashboards; scope selects the trace slice; method is how it grades.

object
One of:

Deterministic rule. file_contains is rejected for observers (session filesystems are not part of the observable trace contract).

object
method
required
string
Allowed values: rule
rule
required
One of:

Final assistant message contains substring.

object
text
required
string
type
required
string
Allowed values: contains
weight
number format: double
key
required

Stable name within the observer (score series name).

string
scope

Trace slice this scorer grades.

string
Allowed values: turn session tool
tools

Tool scope only: grade calls to these tools. Empty or absent grades every tool call.

Array<string> | null
status
required

Lifecycle status.

string
Allowed values: active paused archived deleted
updated_at
required
string format: date-time

Example

{
"alert": {
"min_pass_rate": 0.8,
"min_scored": 20,
"window_hours": 24
},
"description": "Grades support replies for grounded answers.",
"id": "observer_01933b5a000070008000000000000001",
"name": "Support answer quality",
"sampling_rate": 0.1,
"scorers": [
{
"method": "llm_judge",
"scope": "turn"
}
],
"status": "active"
}
404Observer not found

Observer not found