Sign in

v62

latestOpenAPI 3.0.3raw.githubusercontent.com2026-07-31136116265.6 KB
monitor

Get list of defined Monitors

get/v1/projects/{projectOrProductUID}/monitors

Path parameters

projectOrProductUIDstring required

Response

The response body from GET /monitors

aggregate_function'none' | 'sum' | 'average' | 'max' | 'min'

Aggregate function to apply to the selected values before applying the condition. [none, sum, average, max, min]

aggregate_windowstring

The time window to aggregate the selected values. It follows the format of a number followed by a time unit

alertboolean

If true, the monitor is in alert state.

condition_type'greater_than' | 'greater_than_or_equal_to' | 'less_than' | 'less_than_or_equal_to' | 'equal_to' | 'not_equal_to' | 'count'

A comparison operation to apply to the value selected by the source_selector [greater_than, greater_than_or_equal_to, less_than, less_than_or_equal_to, equal_to, not_equal_to]

descriptionstring
disabledboolean

If true, the monitor will not be evaluated.

fleet_filterstring[]
last_routed_atstring

The last time the monitor was evaluated and routed.

namestring
notefile_filterstring[]
per_deviceboolean

Only relevant when using an aggregate_function. If true, the monitor will be evaluated per device, | rather than across the set of selected devices. If true then if a single device matches the specified criteria, | and alert will be created, otherwise the aggregate function will be applied across all devices.

routing_cooldown_periodstring

The time period to wait before routing another event after the monitor | has been triggered. It follows the format of a number followed by a time unit.

silencedboolean

If true, alerts will be created, but no notifications will be sent.

source_selectorstring

A valid JSONata expression that selects the value to monitor from the source. | It should return a single, numeric value.

source_type'event' | 'heartbeat'

The type of source to monitor. Supported values are "event" and "heartbeat".

thresholdinteger

The type of condition to apply to the value selected by the source_selector

uidstring
usage_scopestring

For usage monitors: the scope of aggregation. Supported values are "device" and "fleet".

usage_typestring

For usage monitors: the type of data usage to monitor. Supported values are "cellular" and "satellite".

usage_windowinteger

For usage monitors: the rolling time window in days to sum usage over (e.g. 30 for 30 days).

Example response

[
  {
    "aggregate_window": "10m or 5h30m40s",
    "alert_routes": [
      {
        "email": "example@blues.com"
      }
    ],
    "routing_cooldown_period": "10m or 5h30m40s",
    "source_selector": "body.temperature"
  }
]