How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Coval Metrics API

CRUD operations for custom evaluation metrics

Coval Metrics API is one of 25 APIs that Coval publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Metrics. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 22 operations across 14 paths, and defines 39 schemas. It is described by OpenAPI 3.2.0, at version 1.0.0.

Requests are made against a single base URL, https://api.coval.dev/v1.

22 operations 14 paths 39 schemas 3 DELETE10 GET3 PATCH6 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0.0
Base URL
https://api.coval.dev/v1
Authentication
API Key
Resource Areas
1

Authentication & Security 1

Coval Metrics API declares 1 security scheme for authenticating requests. An API key is passed in the header as x-api-key (ApiKeyAuth). By default, every request must be authenticated.

  • ApiKeyAuth — API key for authentication

Paths & Operations 22

Across 14 paths, the API surfaces 22 operations — 3 DELETE, 10 GET, 3 PATCH, 6 POST. Each is listed below with its method, path, parameters, and response codes.

Metrics 22

CRUD operations for custom evaluation metrics

GET
/metrics
List metrics
listMetrics 6 params → 200401500
POST
/metrics
Create metric
createMetric body → 201400401403500
GET
/metrics/template-variables
List metric template variables
listMetricTemplateVariables → 200401500
GET
/metrics/{metric_id}
Get metric
getMetric 1 param → 200401404500
PATCH
/metrics/{metric_id}
Update metric
updateMetric 1 param body → 200400401403404500
DELETE
/metrics/{metric_id}
Delete metric
deleteMetric 1 param → 200401500
GET
/metrics/{metric_id}/versions
List metric versions
listMetricVersions 1 param → 200401404500
POST
/metrics/{metric_id}/versions/{version_id}/revert
Revert metric version
revertMetricVersion 2 params → 200400401404500
GET
/metrics/recently-deleted
List recently-deleted metrics
listRecentlyDeletedMetrics → 200401500
POST
/metrics/{metric_id}/restore
Restore a recently-deleted metric
restoreMetric 1 param → 200401404500
GET
/metrics/{metric_id}/thresholds
List metric thresholds
listMetricThresholds 3 params → 200401404500
POST
/metrics/{metric_id}/thresholds
Create metric threshold
createMetricThreshold 1 param body → 201400401404500
GET
/metrics/{metric_id}/threshold
Get metric threshold
getMetricThreshold 1 param → 200401404500
PATCH
/metrics/{metric_id}/threshold
Update metric threshold
updateMetricThreshold 1 param body → 200400401404500
DELETE
/metrics/{metric_id}/thresholds/{threshold_id}
Delete metric threshold
deleteMetricThreshold 2 params → 200401404500
GET
/metrics/{metric_id}/baselines
List metric baselines
listMetricBaselines 8 params → 200401404500
POST
/metrics/{metric_id}/baselines
Create metric baseline
createMetricBaseline 1 param body → 201400401404500
GET
/metrics/{metric_id}/baselines/{baseline_id}
Get metric baseline
getMetricBaseline 3 params → 200401404500
PATCH
/metrics/{metric_id}/baselines/{baseline_id}
Update metric baseline
updateMetricBaseline 2 params body → 200400401404500
DELETE
/metrics/{metric_id}/baselines/{baseline_id}
Delete metric baseline
deleteMetricBaseline 2 params → 204401404500
POST
/metrics/{metric_id}/test
Trigger test metric execution
testMetric 1 param body → 202400401403404500503
GET
/models/metric
List available metric models
listMetricModels → 200401500

Schemas 39

The contract defines 39 schemas that model the data the API accepts and returns. The most detailed are MetricResource (22 properties), Baseline (17 properties), UpdateMetricRequest (16 properties), CreateMetricRequest (16 properties). Each schema is shown below with its type and property counts.

TargetCondition
object
The metric's success criteria — the rule that decides which output value counts as a pass/success. It is a comparison operator plus a target value, stored in t…
3 properties 1 required
MetricType
string
Metric evaluation type. - METRICLLMBINARY - Yes/no LLM evaluation - METRICCATEGORICAL - Multi-class classification - METRICNUMERICALLLMJUDGE - Numerical scorin…
PatchThresholdRequest
object
Request body for updating a threshold. Send comparisonoperator: null to clear the threshold.
5 properties 1 required
CreateThresholdResponse
object
1 property 1 required
ThresholdSource
string
Source of the threshold value
TestMetricRequest
object
2 properties 1 required
UpdateMetricBaselineRequest
object
Request body for updating a baseline. All fields optional.
4 properties
CurrentMetricVersion
object
The metric's live version, embedded on MetricResource.
3 properties 3 required
BaselineDetectionMethod
string
Anomaly detection algorithm. Currently only EWMA.
MetricRuntimeConfig
object
LLM model and thinking configuration for metric execution
2 properties
CreateMetricBaselineRequest
object
Request body for creating a baseline. All fields optional.
9 properties
ListMetricVersionsResponse
object
Response for GET /v1/metrics/{metricid}/versions (newest first)
1 property 1 required
GetMetricResponse
object
1 property 1 required
MetricVersionResource
object
A prior, displaced snapshot of a metric's scoring config.
9 properties 6 required
BaselineStatus
string
Baseline lifecycle status.
ErrorResponse
object
1 property 1 required
CreateThresholdRequest
object
Request body for creating a threshold
5 properties 1 required
MetricResource
object
Metric resource
22 properties
ListMetricBaselinesResponse
object
3 properties 1 required
BaselineDirection
string
Which direction(s) of deviation count as anomalous.
ListRecentlyDeletedMetricsResponse
object
Response for GET /v1/metrics/recently-deleted (newest first)
1 property 1 required
UpdateMetricRequest
object
Update metric request (partial update)
16 properties
BaselineConfig
object
Algorithm-specific configuration. Currently only the EWMA detector is supported.
1 property
PatchThresholdResponse
object
1 property 1 required
MetricVersionChangeType
string
How a metric version came about. A revert is a save whose new state mirrors an older version.
MetricTemplateVariableCategory
object
One category of {{prefix.key}} template variables usable in metric prompts.
6 properties 6 required
GetMetricTemplateVariablesResponse
object
2 properties 2 required
MetricThresholdResource
object
Org-specific threshold for a metric
8 properties
MetadataFieldType
string
Data type for metadata field extraction
TestMetricResponse
object
1 property
ListThresholdsResponse
object
2 properties 1 required
MetricModelResource
object
A single LLM model available for metric evaluation
5 properties 5 required
CreateMetricRequest
object
Create metric request
16 properties 3 required
Baseline
object
Anomaly-detection baseline for a metric.
17 properties 7 required
GetThresholdResponse
object
1 property 1 required
ComparisonOperator
string
Comparison operator for thresholds
RecentlyDeletedMetricResource
object
A soft-deleted metric in the Recently Deleted list, with its purge countdown.
6 properties 3 required
ListMetricModelsResponse
object
1 property 1 required
ListMetricsResponse
object
2 properties 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

coval-metrics-api-openapi.yml Raw ↑

Other APIs Coval publishes across the network.

Coval Agents API
Coval API Keys API
Coval Audio API
Coval Conversations API
Coval Dashboards API
Coval Metric Outputs API
Coval Monitor Events API
Coval Monitors API
Coval Mutations API
Coval Organization Conversations Config API
Coval Personas API
Coval Reports API
Where this information came from

This is an independent, third-party profile of Coval Metrics API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.