Reports what this instance is holding.
Errors
401 when nothing was signed in, 403 when the caller is not an
administrator or used a bearer token, 404 when this instance has no
administration.
sessiontessera_session<token>Set by POST /auth/login. A browser sends it automatically; it is HttpOnly, so page scripts cannot read or set it.
What this instance is holding
application/json- response
What one instance is holding, at a glance.
Why this is not a metrics endpoint
These are numbers an operator acts on: "am I near the quota", "how many
accounts are there", "is the sweep keeping up". The dashboard's one trend,
per day, is /admin/stats/history; anything finer belongs in Prometheus.
accounts*integerHow many accounts exist.
int640 <= valueadministrators*integerHow many of those administer the instance.
int640 <= valuebytes_redirected*integerBytes requested by downloads redirected straight to a store.
Requested, not delivered: the store does not report what it sent, so an
abandoned download counts in full. Kept separate so bytes_served still
means what left this machine.
int640 <= valuebytes_served*integerHow many bytes this instance has sent out.
Bytes that left the process, not bytes that reached anybody: a proxy in front holds some, and a caching CDN answers requests this never sees. For what crossed the network, a reverse proxy's log is the authority.
Counted over the shares still here, so a swept share takes its tally with it and this falls when one goes.
int640 <= valuelive_invites*integerHow many invites could still admit an account.
int640 <= valuelive_shares*integerHow many a visitor could still open.
The gap between this and shares is what the sweep has not reached. A
large one means retention is longer than expected, or the sweep is not
running.
int640 <= valuequota_bytes?|The ceiling from storage.max_total_bytes, or null when unset.
null means unset, not unlimited. On an instance taking anonymous
uploads, that combination is what the start-up warning is about.
int640 <= valueshares*integerHow many shares exist, including ones that can no longer be opened.
int640 <= valuestored_bytes*integerBytes of uploaded content still on the store.
int640 <= valuecurl -X GET 'https://example.com/api/v1/admin/stats'{ "accounts": 0, "administrators": 0, "bytes_redirected": 0, "bytes_served": 0, "live_invites": 0, "live_shares": 0, "quota_bytes": 0, "shares": 0, "stored_bytes": 0}