Skip to main content

Core API (backend/core-api)

The Core API is a FastAPI backend.

Responsibilities​

  • API v1 routing
  • Auth, RBAC, API keys
  • Modular platform domains
  • Supabase/Postgres access
  • Redis-backed features
  • Webhooks and integrations
  • Observability endpoints
  • Compatibility/legacy adapters

Important paths​

  • backend/core-api/app/main.py
  • backend/core-api/app/api/v1/api.py
  • backend/core-api/app/core/config.py
  • backend/core-api/app/core/auth.py
  • backend/core-api/app/core/api_key_auth.py
  • backend/core-api/app/modules
  • backend/core-api/app/api/v1/legacy
  • backend/core-api/requirements.txt
  • backend/core-api/requirements-prod.txt
  • backend/core-api/Dockerfile

Run locally​

cd backend/core-api
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt
uvicorn app.main:app --reload --host 0.0.0.0 --port 8000

Health and metrics​

  • /health
  • /metrics

Metrics may require METRICS_BEARER_TOKEN outside local/test/CI environments.