API

Governed Interface Draft

The Mullusi API will expose governed service requests through `api.mullusi.com`. Until the control plane is launched, this page is a draft contract and not a production availability claim.

Stability Labels

Label	Meaning
Draft	Contract may change before launch.
Preview	Usable for testing with migration risk.
Stable	Versioned and covered by compatibility policy.

Request Lifecycle

request
  -> authenticate
  -> validate schema
  -> apply governance constraints
  -> execute service action
  -> emit trace
  -> return typed response

Draft Endpoints

Endpoint	Status	Purpose
`GET /health`	Draft	Report service readiness.
`POST /v1/traversals`	Draft	Submit a governed traversal request.
`GET /v1/traversals/{id}`	Draft	Fetch traversal state and trace metadata.

Error Contract

API errors should be typed, explicit, and traceable. Silent failures are not accepted. Each rejected request must include a bounded reason that can be logged and audited.