Api / Admin

GET/v1/admin/tenants

Auth: admin — Status: stable

List all tenants. Used by the admin dashboard.

Request

No path / query / body params.

curl -H "Authorization: Bearer adm_…" \
  http://arbiter.example.com/v1/admin/tenants

Response

200 OK

{
  "tenants": [
    {
      "id": 1,
      "name": "acme",
      "disabled": false,
      "created_at": 1777056438,
      "last_used_at": 1777078022
    }
  ]
}

Field schemas: Data model → Tenant. Tokens are not returned (the DB only stores their digests).

Failure modes

StatusWhenBody
401Missing / invalid admin bearer; tenant token presented.{"error": "..."}
503Server has no admin token configured.{"error": "admin not configured"}

See also