Skip to content

rest.md

Latest commit

 

History

History
30 lines (25 loc) · 1.01 KB

rest.md

File metadata and controls

30 lines (25 loc) · 1.01 KB
Raw

Signed REST — compute · identity · screen

A small, uniform surface for the rest of the stack. Every response carries a signed receipt.

Compute

POST /compute — deterministic computation over your data (forecasts, drivers, levers). Same inputs -> same signed result.

// request
{ "op": "outlook", "scope": { "state": "VT", "product": "PYL-30" } }
// response
{ "result": { "figure": 18.28, "band": [14.2, 22.3], "driver_pct": 18.0 }, "receipt": "gf-5ac8…" }

Verify identity

POST /verify — confirm who/what an action or record claims to be (agent, human, or machine).

{ "valid": true, "subject": "agent:svc-ingest", "on_behalf_of": "acme", "receipt": "mk-1a94…" }

Screen intake

POST /intake — screen anything before it reaches your data. Nothing acts until it is proven safe.

{ "accepted": false, "reason": "unverified executable content", "receipt": "jn-7b2f…" }

Health

GET /health

{ "status": "ok", "records": 22000, "integrity_ok": true }