API Reference
365 endpoints. Base URL: https://api.sgraal.com
Interactive docs: api.sgraal.com/docs (Swagger UI)
Core
/v1/preflightCore decision endpoint. 87-module scoring pipeline.
New: grok_context param, sgraal_override / grok_decision / formal_override / notification_sent response fields
/v1/preflight/batchBatch scoring — up to 100 entries per call.
/v1/preflight/zkZero-knowledge mode — SHA-256 proof hash, no content exposure.
/v1/healRepair memory entries: REFETCH, VERIFY_WITH_SOURCE, REBUILD_WORKING_SET.
/v1/explainNatural language explanation — developer/compliance/executive audiences.
/v1/outcomeClose outcome — success/failure/partial with component attribution.
Comparison & Analysis
/v1/compare/grokSide-by-side Sgraal vs Grok comparison. Formal contradiction detection.
/v1/propagation/traceTrace memory propagation — cascade risk, containment, affected agents.
/v1/fidelity/certifyCertify memory fidelity with cryptographic proof.
/v1/cross-agent-checkMulti-agent conflict detection with anti-consensus safeguard.
Memory Management
/v1/audit-logDecision audit trail with timestamp + omega mapping.
/v1/analytics/summaryFleet-wide decision analytics.
Standards
/v1/standard/memcube-specMemCube v2 JSON Schema.
/v1/standard/score-definitionSMRS v1.0 formal score definition.
Audit Log
/v1/audit-log/chain-verifyVerify cryptographic integrity of the SHA256-chained audit log. Returns the verified-up-to entry id and the first divergence point if any.
/v1/audit-log/exportExport the full hash-chained log. ?format=json | cef | leef. Each record carries the prior-hash for independent re-verification.
/v1/audit-log/verifyVerify a single audit entry's signature and chain position by id.
Compliance
/v1/compliance/eu-ai-act/declarationGenerate an EU AI Act conformity declaration scoped to your account. Article-level evidence mapping based on system risk classification. JSON output suitable for regulator submission.
/v1/compliance/slaSLA report for the current billing period. Latency, availability, decision counts.
Forensics
/v1/forensics/analyzeForensic decomposition of a past preflight decision. Body: {"request_id": "..."}. Returns: detection layers fired, memory entries contributing to the decision, replay path, and a stable forensics_id.
/v1/forensics/{forensics_id}/reportRetrieve a previously-generated forensic report by id.
Calibration
/v1/calibration/runTrigger a calibration run against the built-in adversarial corpus using your account's current configuration.
/v1/calibration/reportReturns the most recent calibration report.
/v1/calibration/human-reviewCases the calibration run flagged for human review.
/v1/calibration/resolve/{case_id}Mark a human-review case as resolved with a decision label.
Runtime Safety
/v1/firewall/rulesList per-namespace write firewall rules. POST to upsert, DELETE /v1/firewall/rules/{namespace} to remove.
/v1/firewall/violationsRecent write firewall violations. Pagination via ?limit= and ?cursor=.
/v1/circuit-breaker/statusCurrent circuit breaker state per agent and per cross-domain rule. Includes which agents are currently blocked and remaining cooldown.
Full interactive documentation with request/response examples:
Open Swagger UI →