:4000 · API

Aegis EA — Control plane API

You're looking at the backend. The user interface lives on a different port.

Looking for the app? Open http://localhost:3000. The UI (cockpit, console, admin) runs on :3000 and calls this API on :4000 for data.

Open the web app → GET /health GET /api/policies

Architecture

:3000 — @aegis/web

Next.js 14 user interface. Cockpit, assistant console, ops admin. Signs users in via Supabase Auth; calls this API for all data.

:4000 — @aegis/api

NestJS control plane (this server). 42 routes across 15 domain modules, Socket.IO realtime on /realtime, webhook receivers, Action Gateway.

@aegis/worker

BullMQ workers for 9 durable workflows (scheduling, meeting-brief, summary, follow-up, voice...). Requires Redis.

:4100 — @aegis/voice-gateway

WebSocket bridge that terminates Twilio Media Streams, pipes audio through Deepgram → Claude → ElevenLabs for live voice workflows.

Public endpoints (no auth)

GET/health
GET/connectors/google/callback
GET/connectors/slack/callback
POST/webhooks/slack/events
POST/webhooks/slack/interactive
POST/webhooks/twilio/status
POST/webhooks/twilio/voice
GET/POST/webhooks/whatsapp
POST/webhooks/gmail/push
POST/webhooks/google/calendar

Authenticated endpoints (bearer JWT)

GET/api/auth/me
GET/api/users
GET/POST/api/contacts
GET/api/calendar/upcoming
GET/api/calendar/freebusy
POST/api/calendar/events
GET/api/meetings
GET/api/meetings/:id
POST/api/meetings/:id/brief
POST/api/meetings/:id/summary
GET/PATCH/api/action-items
GET/POST/api/follow-ups
GET/api/approvals
POST/api/approvals/:id/decision
GET/api/workflows
POST/api/workflows/enqueue
GET/api/daily-plan
POST/api/daily-plan/regenerate
GET/api/connectors
GET/api/connectors/google/authorize
GET/api/connectors/slack/authorize
GET/POST/api/policies
POST/api/policies/evaluate
GET/POST/api/memory
GET/api/memory/search
GET/api/audit
GET/api/notifications
PATCH/api/notifications/:id/read

Calls to /api/* require a Supabase JWT in the Authorization: Bearer header. Sign in at localhost:3000/signin to obtain one — the web app attaches it automatically.