Create metric baseline - Coval Documentation

curl --request POST \
  --url https://api.coval.dev/v1/metrics/{metric_id}/baselines \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "agent_id": "gk3jK9mPq2xRt5vW8yZaBc",
  "test_set_id": "01HXKZ4M5N6P7Q8R9TESTSET01",
  "display_name": "Resolution rate baseline",
  "status": "ACTIVE",
  "detection_method": "EWMA",
  "sigma_threshold": 2.5,
  "direction": "ABOVE",
  "config": {
    "time_constant_seconds": 604800
  }
}
'

{
  "ulid": "01HXKZ4M5N6P7Q8R9STVWXYZAB",
  "metric_id": "abc123def456ghi789jklm",
  "agent_id": "gk3jK9mPq2xRt5vW8yZaBc",
  "test_set_id": "01HXKZ4M5N6P7Q8R9TESTSET01",
  "persona_id": null,
  "display_name": "Resolution rate baseline",
  "status": "ACTIVE",
  "detection_method": "EWMA",
  "baseline_float": null,
  "baseline_sigma": null,
  "observation_count": 0,
  "sigma_threshold": 2.5,
  "direction": "ABOVE",
  "sigma_bands": null,
  "last_processed_run_completed_at": null,
  "created_at": "2026-04-23T17:00:00Z",
  "last_updated_at": "2026-04-23T17:00:00Z"
}

{
  "error": {
    "message": "<string>",
    "details": [
      {
        "field": "<string>",
        "description": "<string>"
      }
    ]
  }
}

{
  "error": {
    "code": "UNAUTHENTICATED",
    "message": "Authentication failed",
    "details": [
      {
        "field": "X-API-Key",
        "description": "Invalid or missing API key"
      }
    ]
  }
}

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Metric not found",
    "details": [
      {
        "field": "metric_id",
        "description": "No metric found with this ID"
      }
    ]
  }
}

{
  "error": {
    "code": "INTERNAL",
    "message": "Internal server error"
  }
}

POST

metrics

{metric_id}

baselines

curl --request POST \
  --url https://api.coval.dev/v1/metrics/{metric_id}/baselines \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "agent_id": "gk3jK9mPq2xRt5vW8yZaBc",
  "test_set_id": "01HXKZ4M5N6P7Q8R9TESTSET01",
  "display_name": "Resolution rate baseline",
  "status": "ACTIVE",
  "detection_method": "EWMA",
  "sigma_threshold": 2.5,
  "direction": "ABOVE",
  "config": {
    "time_constant_seconds": 604800
  }
}
'

{
  "ulid": "01HXKZ4M5N6P7Q8R9STVWXYZAB",
  "metric_id": "abc123def456ghi789jklm",
  "agent_id": "gk3jK9mPq2xRt5vW8yZaBc",
  "test_set_id": "01HXKZ4M5N6P7Q8R9TESTSET01",
  "persona_id": null,
  "display_name": "Resolution rate baseline",
  "status": "ACTIVE",
  "detection_method": "EWMA",
  "baseline_float": null,
  "baseline_sigma": null,
  "observation_count": 0,
  "sigma_threshold": 2.5,
  "direction": "ABOVE",
  "sigma_bands": null,
  "last_processed_run_completed_at": null,
  "created_at": "2026-04-23T17:00:00Z",
  "last_updated_at": "2026-04-23T17:00:00Z"
}

{
  "error": {
    "message": "<string>",
    "details": [
      {
        "field": "<string>",
        "description": "<string>"
      }
    ]
  }
}

{
  "error": {
    "code": "UNAUTHENTICATED",
    "message": "Authentication failed",
    "details": [
      {
        "field": "X-API-Key",
        "description": "Invalid or missing API key"
      }
    ]
  }
}

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Metric not found",
    "details": [
      {
        "field": "metric_id",
        "description": "No metric found with this ID"
      }
    ]
  }
}

{
  "error": {
    "code": "INTERNAL",
    "message": "Internal server error"
  }
}

Authorizations

X-API-Key

string

header

required

API key for authentication

Path Parameters

metric_id

string

required

22-character metric ID

Pattern: ^[a-zA-Z0-9]{22}$

Body

application/json

Request body for creating a baseline. All fields optional.

agent_id

string | null

Agent ID. Null for org-wide baselines.

test_set_id

string | null

Test set ULID. Null for monitoring.

persona_id

string | null

Persona ULID. Null when the baseline covers all personas.

display_name

string | null

User-facing label.

Maximum string length: 200

status

enum<string>

Initial status. Defaults to STANDBY.

Available options:

ACTIVE,

STANDBY,

ARCHIVED

detection_method

enum<string>

Algorithm. Defaults to EWMA.

Available options:

EWMA

sigma_threshold

number | null

Sigmas from the baseline that constitute an anomaly. Defaults to 2.0.

Required range: x > 0

direction

enum<string>

Which direction(s) of deviation count as anomalous. Defaults to BOTH.

Available options:

BOTH,

ABOVE,

BELOW

config

object

Algorithm-specific configuration. Currently only the EWMA detector is supported.

Show child attributes

Response

Baseline created successfully

Anomaly-detection baseline for a metric.

ulid

string

required

Baseline ULID.

Example:

"01HXKZ4M5N6P7Q8R9STVWXYZAB"

status

enum<string>

required

Baseline lifecycle status.

Available options:

ACTIVE,

STANDBY,

ARCHIVED

detection_method

enum<string>

required

Anomaly detection algorithm. Currently only EWMA.

Available options:

EWMA

sigma_threshold

number

required

Sigmas from the baseline that constitute an anomaly.

direction

enum<string>

required

Which direction(s) of deviation count as anomalous.

Available options:

BOTH,

ABOVE,

BELOW

created_at

string<date-time>

required

last_updated_at

string<date-time>

required

metric_id

string | null

Metric ULID.

agent_id

string | null

Agent ID. Null for org-wide baselines.

test_set_id

string | null

Test set ULID. Null for monitoring.

persona_id

string | null

Persona ULID. Null when the baseline covers all personas.

display_name

string | null

User-facing label.

baseline_float

number | null

Current baseline mean estimate.

baseline_sigma

number | null

Current baseline standard deviation estimate.

observation_count

integer

default:0

Number of observations processed.

sigma_bands

object | null

Computed sigma bands keyed by level (e.g. upper_1sigma, lower_2sigma, upper_2sigma). Null when baseline stats are not yet populated. Levels controlled by the sigma_levels query param.

Show child attributes

last_processed_run_completed_at

string<date-time> | null

Cursor: when the last processed run completed.

List metric baselines Get metric baseline

⌘I