Aerovy Platform logo

Get a metric definition

GEThttps://spectra.api.aerovy.com/v2/definitions/metrics/{metricId}

Returns a single metric definition by id. Requires an API key with the read action scoped to the metric.

Loading code example
Loading code example

Authorizations

apiKeystringheaderrequired

API key passed in the header.

Path Parameters

metricIdstringrequired

The metric id.

Response

application/json

The metric definition.

metricIdstring

Stable identifier for the metric.

namestring

Programmatic name of the metric.

displayNamestring

Human-readable name of the metric.

descriptionstring

Description of what the metric measures.

unitLabelstring

Unit label for the metric's values.

dataTypestring

The metric's data type.

defaultAggregationstring

Default aggregation used when binning this metric.

tagsarray<string>

Free-form tags applied to the metric.

enumValuesnull | array

Allowed enumerated values, when the metric is enum-typed.

isDeletedboolean

Whether the metric has been soft-deleted.

createdAtstring<date-time>

Timestamp (UTC) when the metric was created.

updatedAtnull | string<date-time>

Timestamp (UTC) when the metric was last updated.

createdBystring

Identifier of the actor that created the metric.

updatedBynull | string

Identifier of the actor that last updated the metric.