API

Current HTTP and WebSocket surface.

The default server base is http://127.0.0.1:8080. This page focuses on the routes operators and integrations will actually use.

Core entry points

Method Path Purpose
GET/healthBasic process health.
GET/readinessRuntime readiness snapshot.
GET/dashboardMain operator dashboard.
POST/chatLegacy simple chat compatibility endpoint.
WS/wsWebSocket bridge for event and chat traffic.

API domains

Domain Representative routes
Config/api/config, /api/config/providers, /api/config/overview, /api/config/plugin-trust, /api/config/model-routing
Monitor/api/monitor/health, /api/monitor/runtime, /api/monitor/events, /api/monitor/embeddings, /api/monitor/baa
Chat/api/chat/sessions, /api/chat/context-summary, /api/chat/send, /api/chat/voice/transcribe, /api/chat/voice/synthesize
Daydream/api/daydream/summary, /api/daydream/reflections, /api/daydream/conflicts, /api/daydream/promotions
Memory/api/memory/stats, /api/memory/landscape, /api/memory/node-detail, /api/memory/retrieval-inspect
Operations/api/operations/sessions, /api/operations/receipts, /api/operations/tasks, /api/operations/work, /api/operations/qualification
Usage/api/usage/overview
Identity/api/identity, /api/identity/self, /api/identity/user, /api/identity/musubi, /api/identity/somatic
Executive/api/executive, /api/executive/snapshot, /api/executive/commitments, /api/executive/plans
Platform/api/platform/capabilities, /api/platform/extensions, /api/platform/extensions/install, /api/platform/policies/install-update
Phone/api/phone/status, /api/phone/config, /api/phone/session-profiles, /api/phone/autoconfigure, /api/phone/call-owner
Schedule/api/schedule/items, /api/schedule/calendar, /api/schedule/runs, /api/schedule/items/{schedule_id}/trigger
Telemetry/api/telemetry/events, /api/telemetry/kinds, /api/telemetry/sessions, /api/telemetry/stats
Telegram/api/telegram/status, /api/telegram/config, /api/telegram/pairings/{code}/approve

Example requests

curl -X POST http://127.0.0.1:8080/api/chat/send \
  -H "Content-Type: application/json" \
  -d '{"session_id":"default","message":"Hello OpenCAS"}'
curl "http://127.0.0.1:8080/api/chat/context-summary"
curl "http://127.0.0.1:8080/api/memory/landscape?limit=40&edge_kind=semantic"
curl "http://127.0.0.1:8080/api/usage/overview?window_days=7&bucket_hours=6"

Notes

  • The mounted FastAPI app also exposes /openapi.json, /docs, and /redoc.
  • The current running app exposes a large surface; the tables above emphasize the stable operator-facing routes instead of listing every process-control variant inline.
  • For detailed route examples, use the markdown API reference and the live FastAPI schema together.