API Reference

365 endpoints. Base URL: https://api.sgraal.com

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

Core

POST/v1/preflight

Core decision endpoint. 87-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.

Comparison & Analysis

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.

Memory Management

GET/v1/audit-log

Decision audit trail with timestamp + omega mapping.

GET/v1/analytics/summary

Fleet-wide decision analytics.

Standards

GET/v1/standard/memcube-spec

MemCube v2 JSON Schema.

GET/v1/standard/score-definition

SMRS v1.0 formal score definition.

Audit Log

GET/v1/audit-log/chain-verify

Verify cryptographic integrity of the SHA256-chained audit log. Returns the verified-up-to entry id and the first divergence point if any.

GET/v1/audit-log/export

Export the full hash-chained log. ?format=json | cef | leef. Each record carries the prior-hash for independent re-verification.

GET/v1/audit-log/verify

Verify a single audit entry's signature and chain position by id.

Compliance

GET/v1/compliance/eu-ai-act/declaration

Generate 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.

GET/v1/compliance/sla

SLA report for the current billing period. Latency, availability, decision counts.

Forensics

POST/v1/forensics/analyze

Forensic 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.

GET/v1/forensics/{forensics_id}/report

Retrieve a previously-generated forensic report by id.

Calibration

POST/v1/calibration/run

Trigger a calibration run against the built-in adversarial corpus using your account's current configuration.

GET/v1/calibration/report

Returns the most recent calibration report.

GET/v1/calibration/human-review

Cases the calibration run flagged for human review.

POST/v1/calibration/resolve/{case_id}

Mark a human-review case as resolved with a decision label.

Runtime Safety

GET/v1/firewall/rules

List per-namespace write firewall rules. POST to upsert, DELETE /v1/firewall/rules/{namespace} to remove.

GET/v1/firewall/violations

Recent write firewall violations. Pagination via ?limit= and ?cursor=.

GET/v1/circuit-breaker/status

Current 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 →