Skip to main content
These endpoints power the operational substrate: agent work is captured as writeback envelopes, routed through the Memory Gateway into a reviewable proposal queue, and promoted to canonical brain objects. They are primarily operator/dashboard-facing (surfaced in Mission Control) rather than day-to-day agent tools.
The Memory Gateway runs in one of three modes via BRAIN_MEMORY_GATEWAY_MODE: shadow (proposals recorded, nothing auto-promoted), proposal (new agent memory routed through proposals), enforced (canonical writes require promotion). Default is shadow.

​
Writebacks

Agent-run memory intake envelopes.
  • POST /v1/brain/writebacks — submit a writeback envelope (idempotency-keyed).
  • GET /v1/brain/writebacks — list writebacks.
  • GET /v1/brain/writebacks/:id — a writeback and its derived proposals.

​
Memory proposals

The human-review queue. Proposals are routed by the Memory Gateway (auto_promote, human_review, merge, reject, quarantine, tombstone, needs_evidence).
  • GET /v1/brain/proposals — list proposals.
  • GET /v1/brain/proposals/:id — a single proposal.
  • GET /v1/brain/proposals/:id/events — proposal audit trail.
  • PATCH /v1/brain/proposals/:id — edit a proposal’s payload/metadata.
  • POST /v1/brain/proposals/:id/accept — accept + promote. Body: { reason?, edited_payload? }.
  • POST /v1/brain/proposals/:id/reject — reject. Body: { reason? }.
  • POST /v1/brain/proposals/:id/merge — merge into a target. Body: { merge_target_id, reason? }.
  • POST /v1/brain/proposals/:id/quarantine — quarantine. Body: { reason? }.

​
Canonical objects

GET /v1/brain/objects and GET /v1/brain/objects/:id — promoted canonical memory objects (decision, runbook, task_outcome, skill, approval, artifact).

​
Operator status & gates

  • GET /v1/brain/ops-status — gateway mode, proposal counts, recent runs, runtime.
  • GET /v1/brain/prod-gates?scope=&scope_ref= — production-readiness gates: deletion proof, projection health, bake-off registration, golden thresholds.
  • POST /v1/brain/bakeoff/runs and POST /v1/brain/bakeoff/runs/:id/run — register and execute an engine bake-off.