Interfaces
HTTP API
The service is a FastAPI application on loopback. Every route calls the same operation set as the CLI and the model tools.
Note The API binds to
127.0.0.1:8765only. There is no hosted endpoint yet.
Health
| Route | Purpose |
|---|---|
GET /health/live |
The process is up |
GET /health/ready |
The service can serve requests |
Resource groups
| Group | What it covers |
|---|---|
| Sessions | Sign in and out of the local workspace |
| Businesses and contracts | The businesses you can see, and their installed contract |
| Users | Members and their roles |
| Facts and links | Reads as of a time, through your view |
| Sources and observations | Declared sources, and observations pushed by a source token |
| Objects | Context, query, merge and split |
| Named queries | The queries a contract declares |
| Actions | Evaluate and assess an action against current evidence |
| Proposals | Create, approve, execute, reconcile, and read outcomes |
| Events | The event log and chain verification |
Pushing an observation
A source holding a scoped source token pushes observations to its own endpoint.
POST /api/businesses/{business}/sources/{source}/observations
{ "entity": "Supplier", "subject": "supplier-b", "fact": "Supplier.active", "value": false,
"evidence_ref": "supplier_registry:supplier-b:active", "effective_at": "…", "observed_at": "…" }
API tokens
Scoped API tokens are minted by a signed-in user and used by the Python SDK.
POST /api/me/tokens