Reference

API reference

The complete public memory contract is five operations. Control-plane signup, usage and admin routes are not additional memory primitives.

GET /v1/status

Returns product readiness, project ID, plan, request usage, limit, trial expiry, checkpoint count and failure count.

POST /v1/preflight

Required: task. Optional: current_context, limit (1–50), scope_lock. Returns work_receipt and resume_from.

POST /v1/context

Required: task. Optional: current_context, limit. Returns ranked verified checkpoints and bounded failures.

POST /v1/outcomes

Requires work_receipt, operation, expected_result, observed_result, success_state, bounded_condition, evidence_refs, verification_basis. Optional: next_action, scope_lock, idempotency_key.

Successful writes return persisted:true, readback_verified:true and an outcome_id.

POST /v1/failures

Requires work_receipt, error_code, operation, observed_result, bounded_condition, evidence_refs, verification_basis. A saved failure is scoped evidence, not a universal prohibition.