Skip to content
EverrunsEverruns
Everruns Cloud is open in early access. Run agents without operating the platform.

List observers.

GET
/v1/observers
curl --request GET \
  --url https://app.everruns.com/api/v1/observers

Parameters

Section titled “ Parameters ”

Query Parameters

Section titled “Query Parameters”
include_archived
boolean

Include archived observers.

Responses

Section titled “ Responses ”

200

Section titled “200”

Success

Media typeapplication/json

Response wrapper for list endpoints. All list endpoints return responses wrapped in a data field.

object
data
required

Array of items returned by the list operation.

Array<object>

An observer: online scoring config over production sessions.

object
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
status
required

Lifecycle status.

string
Allowed values: active paused archived deleted
updated_at
required
string format: date-time
Example
{
  "data": [
    {
      "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"
    }
  ]
}