API Reference

255+ endpoints. Base URL: https://api.sgraal.com

Interactive docs: api.sgraal.com/docs (Swagger UI)

Core

POST/v1/preflight

Core decision endpoint. 83-module scoring pipeline.

New: grok_context param, sgraal_override / grok_decision / formal_override / notification_sent response fields

POST/v1/preflight/batch

Batch scoring — up to 100 entries per call.

POST/v1/preflight/zk

Zero-knowledge mode — SHA-256 proof hash, no content exposure.

POST/v1/heal

Repair memory entries: REFETCH, VERIFY_WITH_SOURCE, REBUILD_WORKING_SET.

POST/v1/explain

Natural language explanation — developer/compliance/executive audiences.

POST/v1/outcome

Close outcome — success/failure/partial with component attribution.

POST/v1/compare/grok

Side-by-side Sgraal vs Grok comparison. Formal contradiction detection.

POST/v1/propagation/trace

Trace memory propagation — cascade risk, containment, affected agents.

POST/v1/fidelity/certify

Certify memory fidelity with cryptographic proof.

POST/v1/cross-agent-check

Multi-agent conflict detection with anti-consensus safeguard.

POST/v1/court/arbitrate

Formal arbitration with Z3 verification. overridable: false.

POST/v1/memory/passport/export

Cryptographically signed memory snapshot. 3 TTL levels: ephemeral/standard/archival.

GET/v1/memory/passport/{id}/verify

Verify passport signature integrity.

GET/v1/audit-log

Decision audit trail with timestamp + omega mapping.

GET/v1/analytics/summary

Fleet-wide decision analytics.

GET/v1/standard/memcube-spec

MemCube v2 JSON Schema.

GET/v1/standard/score-definition

SMRS v1.0 formal score definition.

Full interactive documentation with request/response examples: