Skip to main content
POST
Create a new metric version

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

metric_id
string
required

The unique identifier of the metric to version

Body

application/json

Request body for POST /v1/metrics/{metric_id}/versions

message
string
required
content
object
required

Metric definition snapshot accepted by POST /v1/metrics/{metric_id}/versions. Six fields are optional and fall back to server-side defaults when omitted:

  • description""
  • return_type"float"
  • enabled_in_prodtrue for HUMAN metrics, false otherwise
  • needs_ground_truthfalse
  • sampling_percentage10
  • filters{ "filterArray": [] }
deploy_immediately
boolean

Response

Metric version created successfully

Response for POST /v1/metrics/{metric_id}/versions

success
enum<boolean>
required
Available options:
true
data
object
required

A versioned snapshot of a metric definition.