at.happyproto.fleet.getVersions Documentation (EN)

main query

HappyView version distribution and upgrade lag. Admin only.

Output

Encodingapplication/json

have integer Optional

History available, when accruing.

need integer Optional

History required, when accruing.

status string Required

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

Known values: ok, accruing, withheld

unit string Optional

No description available.

Known values: days, snapshots

versions array Required

No description available.

Errors

AuthRequired This endpoint requires an authenticated caller.

Forbidden The caller is not a HappyProto admin.

Upstream The telemetry store could not be queried.

Try It

Requests are sent directly from your browser. Some servers may block requests due to CORS.

Service Endpoint Base URL for XRPC calls (e.g., https://api.bsky.social)

View raw schema

{
  "description": "HappyView version distribution and upgrade lag. Admin only.",
  "errors": [
    {
      "description": "This endpoint requires an authenticated caller.",
      "name": "AuthRequired"
    },
    {
      "description": "The caller is not a HappyProto admin.",
      "name": "Forbidden"
    },
    {
      "description": "The telemetry store could not be queried.",
      "name": "Upstream"
    }
  ],
  "output": {
    "encoding": "application/json",
    "schema": {
      "properties": {
        "have": {
          "description": "History available, when accruing.",
          "type": "integer"
        },
        "need": {
          "description": "History required, when accruing.",
          "type": "integer"
        },
        "status": {
          "description": "Why a figure is absent. Branch on this, never on field presence.",
          "knownValues": [
            "ok",
            "accruing",
            "withheld"
          ],
          "type": "string"
        },
        "unit": {
          "knownValues": [
            "days",
            "snapshots"
          ],
          "type": "string"
        },
        "versions": {
          "items": {
            "ref": "#version",
            "type": "ref"
          },
          "type": "array"
        }
      },
      "required": [
        "status",
        "versions"
      ],
      "type": "object"
    }
  },
  "type": "query"
}

version object

No description available.

Properties

adopters integer Optional

No description available.

firstSeen string datetime Optional

First appearance anywhere in the fleet.

instances integer Required

No description available.

medianDaysToAdopt integer Optional

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

version string Required

No description available.

View raw schema

{
  "properties": {
    "adopters": {
      "type": "integer"
    },
    "firstSeen": {
      "description": "First appearance anywhere in the fleet.",
      "format": "datetime",
      "type": "string"
    },
    "instances": {
      "type": "integer"
    },
    "medianDaysToAdopt": {
      "description": "Median days from fleet-first-seen to adoption. Non-adopters excluded, never counted as infinite.",
      "type": "integer"
    },
    "version": {
      "type": "string"
    }
  },
  "required": [
    "version",
    "instances"
  ],
  "type": "object"
}