Fleet

Fleet health

Returns device counts across the org.

Example

curl https://api.plexus.company/v1/fleet/health \
  -H "x-api-key: YOUR_API_KEY"

Response

{
  "sources_total": 24,
  "sources_online": 19
}

Fleet metrics

Query a single metric across all devices. Returns one time-series per device.

Query params

The interval is auto-computed from the window and is always at least 1m for fleet queries (no raw-row mode). The chosen interval is returned in the response.

Example

curl "https://api.plexus.company/v1/fleet/metrics?metric=cpu.percent&last=7d" \
  -H "x-api-key: YOUR_API_KEY"

Response

{
  "metric": "cpu.percent",
  "interval": "1h",
  "sources_online": 19,
  "sources_w_metric": 22,
  "sources": [
    {
      "source_id": "robot-01",
      "online": true,
      "timestamp_ms": [1746969600000, 1746973200000],
      "avg": [14.2, 18.7],
      "min": [8.1, 11.3],
      "max": [31.4, 44.2],
      "count": [60, 60]
    }
  ],
  "truncated": false
}

truncated is true when the query hit the 10 000-row cap — narrow the window if you see it. sources_w_metric is the number of devices that reported this metric within the requested window — the same as the length of the sources array. Each device's series uses parallel arrays — same format as the single-device query.