Skip to content

API Reference

Terng Dechanon edited this page Jul 24, 2026 · 2 revisions

API Reference

267 routes. These are the ones worth knowing. Base: http://127.0.0.1:8766

System

Method Path Purpose
GET /api/system/health full report — 14 checks
GET /api/system/health/quick liveness only
GET /api/ecosystem/* the generated SELF.md manifest
curl http://127.0.0.1:8766/api/system/health
# {"ok":true,"status":"GREEN","summary":"all 14 checks pass","checks":[...]}

Council — 28 routes

Method Path Purpose
GET /api/council/dashboard the Council Intelligence UI
GET /api/council/sessions past deliberations
GET /api/council/reputation per-member estimates

House Mind — 39 routes

Method Path Purpose
GET /api/house/state current shared understanding
POST /api/house/state update
GET /api/house/events live event stream (SSE)

Connections and models

Method Path Purpose
GET /api/providers supported provider types
GET/POST /api/connections list / create
POST /api/connections/{id}/activate make it the active connection
GET /api/connections/{id}/ping confirm it answers
GET /api/models what the active connection offers
GET/PUT /api/router/config routing rules
GET /api/router/audit what actually routed where

Governance

Method Path Purpose
GET /api/governance/config the constitution in force

Skills and tools

Method Path Purpose
GET /api/skills the registry
GET /api/tools the tool catalogue

Learning loop

Method Path Purpose
GET /api/learning/loop staked hypotheses and verdicts
GET /api/learning/dashboard the observatory page

⚠️ There is no authentication

The API binds to 127.0.0.1 by design. It can run shell commands and write files, and it has no built-in authentication. Do not expose port 8766 to a network without putting an authenticating proxy in front of it. See Security Model.

→ Next: Security Model

Clone this wiki locally