bBoson
Docs/Admin API

Admin API

The authenticated operational API used by the Dashboard.

The Admin API is the operational control plane. The Dashboard is a client of this API and does not embed Server internals. The current CLI focuses on local project lifecycle rather than wrapping Admin endpoints.

Authentication

Administrators authenticate with scoped API keys or a bootstrap token in local development. Application user auth remains separate from Admin authorization.

What it covers

Typical Admin surfaces include:

  • Health, overview metrics, and request traces
  • Configuration inspection (redacted)
  • Administrators and API keys
  • Organizations, users, and storage inspection
  • Jobs, event log / outbox delivery, and audit trail
  • Notification delivery history

Use the API

curl http://localhost:8080/admin/v1/health \
  -H 'authorization: Bearer local-development-token'

The Dashboard uses the configured Boson API URL. Custom operator tools should treat the Admin API as the source of truth and request only the scopes they need.