Courtroom

GET /api/v1/memories/{memory_id}/courtroom

Courtroom is the evidence inspection API. It explains why a memory can or cannot be trusted, what evidence supports it, whether it is current, and what the MiniMax judge concluded when AI judgment is available.

Deterministic guardrails run first. MiniMax can downgrade, ask for review, or surface contradictions, but it cannot upgrade rejected, stale, superseded, forensic, test/eval, secret-like, or non-current rows to trusted.

Auth

Use a scoped key with courtroom.read or an owner/admin session. Non-admin keys can only read Courtroom cases visible to their effective scope.

Path and query parameters

Name	Required	Description
memory_id	Yes	Memory or canonical fact identifier.
query	No	Optional cross-examination question.
include_ai	No	Set to true to include cached/generated AI judgment.
refresh	No	Admin-only regeneration hint for cached AI judgment.

Example

curl "https://edge-api.jithendranara.dev/api/v1/memories/mem_docs_surface/courtroom?include_ai=true" \
  -H "Authorization: Bearer $UNIFIED_MEMORY_API_KEY"

Response shape

{
  "memory_id": "mem_docs_surface",
  "deterministic_verdict": {
    "verdict": "caution",
    "reasons": [
      "pending_review",
      "single_support"
    ],
    "temporal_state": "current"
  },
  "ai_judgment": {
    "status": "cached",
    "ai_verdict": "needs_review",
    "recommended_action": "collect_more_evidence",
    "confidence": 0.62,
    "rationale": "The claim is specific and plausible but has only one clean support."
  },
  "final_verdict": "needs_review",
  "final_recommended_action": "collect_more_evidence",
  "guardrail_overrides": [
    {
      "rule": "deterministic_stricter_than_ai",
      "ai_verdict_downgraded": true
    }
  ],
  "evidence_status": "available",
  "courtroom_status": "ready",
  "judge_provider": "minimax",
  "judge_model": "MiniMax-M2.7",
  "judgment_cache_status": "hit",
  "supporting_evidence": [
    {
      "evidence_id": "ev_01",
      "redacted_excerpt": "Hosted docs are a product surface..."
    }
  ],
  "missing_evidence": [
    "A second clean support or owner approval."
  ],
  "contradiction_hypotheses": [],
  "cross_examination_questions": [
    "Was this fact observed from the repo or inferred from planning notes?"
  ],
  "risk_flags": []
}

Common outcomes

Status	Meaning
200	Case loaded. AI judgment may be cached, generated, unavailable, or omitted.
401	Missing or invalid key/session.
403	Key cannot inspect this memory scope.
404	Memory not found or not visible.
409	Refresh requested but case is locked by another judge run.
422	Invalid query parameter.
200 unavailable	Deterministic report returned but provider, Google revisions, or evidence refs are unavailable.

UI route

The product UI deep link is:

https://um.jithendranara.dev/memories?view=courtroom&case=mem_docs_surface

Next steps

• Read the Memory Courtroom concept.
• Use Recall to see how Courtroom links appear in retrieval.