at.happyproto.fleet.getVersions

HappyView version distribution and upgrade lag. Admin only.

Repository @happyproto.at did:plc:mo7vq4jbioxwafy5zkcc3eux namespace authority

Details · query

Kind	query
Authority	fleet.happyproto.at
Indexed	22d ago · 2026-10-19

Compare Edit in builder → Fork →

Query

query · GET

Output

application/json

have

integer

History available, when accruing.

need

integer

History required, when accruing.

status

requiredstring

Why a figure is absent. Branch on this, never on field presence.

knownValues: ok | accruing | withheld

unit

string

knownValues: days | snapshots

versions

requiredarray

itemsref

Reference

#version

Errors

AuthRequired

This endpoint requires an authenticated caller.

Forbidden

The caller is not a HappyProto admin.

Upstream

The telemetry store could not be queried.

#version

object

Properties

adopters

integer

firstSeen

string · datetime

First appearance anywhere in the fleet.

instances

requiredinteger

medianDaysToAdopt

integer

Median days from fleet-first-seen to adoption. Non-adopters excluded, never counted as infinite.

version

requiredstring

Similar lexicons

semantic match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.

at.happyproto.fleet.getAdoption
query

Per-subsystem feature adoption, ever-used against active now. Admin only.
at.happyproto.fleet.getIngestHealth
query

Report lag, clock skew and schema-version spread. Lag and skew are separate facts and must not be averaged together. Admin only.
at.happyproto.fleet.getGrowth
query

Fleet and per-instance growth rates from instance_daily_deltas. Counter resets are excluded by the view, so a wiped volume lowers no rate. Admin only.
at.happyproto.fleet.getRetention
query

Survival by first-seen cohort. Manual-mode instances are excluded: they have no reporting cadence to miss, so their silence is not churn. Admin only.
at.happyproto.fleet.listInstances
query

The reporting fleet, one row per instance, from its most recent snapshot. Admin only.