at.happyproto.admin.getFleet

Every host, and every tenant with its host, plan, owner and latest metered hour, for the staff fleet view. Staff only.

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

Details · query

Kind	query
Authority	admin.happyproto.at
Indexed	5d ago · 2026-11-05

Compare Edit in builder → Fork →

Query

query · GET

Output

application/json

hosts

requiredarray

itemsref

Reference

#host

tenants

requiredarray

itemsref

Reference

#tenant

Errors

AuthRequired

This endpoint requires an authenticated caller.

Forbidden

The caller is not HappyProto staff, or the provisioner does not treat them as staff.

NotFound

Passed through from the provisioner.

InvalidSlug

Passed through from the provisioner.

SlugTaken

Passed through from the provisioner.

NotEntitled

Passed through from the provisioner.

InstanceLimit

Passed through from the provisioner.

NoCapacity

Passed through from the provisioner.

OperationInProgress

Passed through from the provisioner.

Upstream

The provisioner is unreachable, not configured, or answered with an error it does not explain to callers.

InvalidRequest

The provisioner refused the request as malformed.

#host

object

Properties

diskGb

requiredinteger

freeDiskGb

integer

Negative when the host is over-committed.

freeMemoryMb

integer

Negative when the host is over-committed.

id

requiredstring

A UUID.

lastSeenAt

string · datetime

Absent until the agent first answers.

memoryMb

requiredinteger

name

requiredstring

reservedDiskGb

requiredinteger

reservedMemoryMb

requiredinteger

state

requiredstring

knownValues: active | draining | degraded | retired

tenantCount

requiredinteger

#owner

object

Properties

did

requiredstring · did

email

string

The address the owner shared, when they did.

emailConfirmed

boolean

Whether the owner's PDS says the address is confirmed. Present only with email.

#plan

object

Properties

diskGb

integer

Its disk quota.

id

requiredstring

memoryMb

integer

Its memory limit.

name

string

#tenant

object

Properties

createdAt

requiredstring · datetime

desiredState

requiredstring

hostId

string

The host it is placed on. Absent when it never was.

id

requiredstring

A UUID.

observedState

requiredstring

owner

requiredref

Reference

#owner

plan

requiredref

Reference

#plan

slug

requiredstring

usage

ref

Its latest metered hour. Absent when it has none yet: never zeros.

Reference

#usage

version

requiredstring

The HappyView release it runs.

#usage

object

Properties

apiClients

integer

diskAvgBytes

integer

diskPeakBytes

integer

hour

requiredstring · datetime

The metered hour these are from.

memAvgBytes

integer

Average over the hour's running time.

memPeakBytes

integer

partial

requiredboolean

Whether the hour has gaps in its samples.

seats

integer

Similar lexicons

semantic match

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

at.happyproto.admin.listHosts
query

Every host, with what its tenants hold. Staff only.
at.happyproto.fleet.getTenantUsage
query

One tenant's metered usage by hour or day, with the hours that have no report. Proxied from the provisioner. Admin only.
at.happyproto.fleet.getCapacity
query

Store capacity: the latest totals, a daily trend, per-collection counts and what each tenant holds. Proxied from the provisioner. Admin only.
at.happyproto.fleet.getCostShape
query

Disk and memory distribution, and bytes per record. Memory is reported as separate anonymous and file-backed figures and is never totalled. Admin only.
at.happyproto.fleet.listInstances
query

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