API Reference

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":[...]}

status is GREEN / YELLOW / RED; ok is false only for RED, which means the House itself is faulty. A degraded optional subsystem — no model runtime reachable, for instance — is YELLOW with ok:true. See Troubleshooting.

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