CAIN-42 CAIN StudioAPI
| Route | Auth | What it does |
|---|---|---|
POST /api/v1/quorum/notarize | X-API-Key | Body {"digest": "<64 hex>", "request_id"?: "..."} → receipt, or 503 NOT_NOTARIZED |
POST /api/v1/quorum/verify | public | Body {"receipt": {...}, "pin"?: "...", "digest"?: "..."} → verdict and every check |
GET /api/v1/quorum/status | public | Cluster, placement, configuration hash, health, limits |
GET /api/v1/live-cluster/membership?cluster=cain-mr-02 | public | Members and keys |
Limits and errors
| Case | Answer |
|---|---|
| No or bad API key | 401 |
| Digest not 64 hex characters; bad request_id | 400 / 422 |
| More than 120 notarizations in an hour for your key | 429 |
| Service-wide 1,200 per hour reached | 429 |
| Cluster could not certify the commit | 503 NOT_NOTARIZED (never a receipt) |
| Verify with no pin | Pinned to this site's live cluster (once the 2026-11-02 fix is deployed); 503 if the membership is unknown |
| Verify rate | 120 per hour per visitor |
FIRME AI CORPORATION · CAIN-42 is a Byzantine trust fabric. Numbers marked "our own check" were run by us, not by an independent party. Nothing on these pages is a certification.