Authentication
Tenant, platform and billing sessions are separate realms. A credential from one realm cannot satisfy another.
Tenant API keys
Use a bearer key issued inside the workspace. Scopes mirror the modules and rights the workspace owns; API access is not a separate paid tier.
bash
curl https://api.gobito.one/v1/cockpit/accounts \ -H "Authorization: Bearer $GOBITO_KEY"
Billing handoff sessions
A workspace administrator asks the tenant app for a short-lived handoff token. The portal exchanges it for an http-only billing session scoped to one tenant id.
The billing realm has no authority to read tenant business data.
Operator credentials
The operator console uses the platform realm and a distinct issuer. Platform tokens cannot enter a tenant route, and tenant tokens cannot enter control-plane routes.