Memory API
The Memory Hub - pool search and browse, item correction and deletion, the capture outbox, and the recall ledger.
The human control surface over the team-memory pools plus the capture outbox and retrieval ledger. All routes are org-session scoped. Personal-scope operations resolve a real authenticated user and fail closed - the dev-org fallback user is never borrowed for a personal pool. See Memory hub.
Every route accepts a scope of org (default) or personal; an invalid value
falls back to org. When memory is not configured, reads return {enabled: false, items: []} rather than an error.
| Method | Path | Description | Notes |
|---|---|---|---|
| GET | /api/memory/search |
Search-driven recall across the resolved pool. | Query scope, q. Returns {enabled, scope, authed, truncated, latencyMs, items} with each item {content, sourceScope, citation}. Personal + unauthenticated returns failedClosed: true. |
| GET | /api/memory/browse |
List stored memory for the viewed pool, newest first. | Query scope. Returns {enabled, scope, authed, total, latencyMs, items}. |
| PATCH | /api/memory/item/:id |
Correct a stored fact in its pool. | Body: scope, content (required), background. {ok: true}. 403 sign-in required (personal) or 403 memory disabled (org) when no pool identity; 502 update failed on upstream not-ok. |
| DELETE | /api/memory/item/:id |
Delete a stored fact from its pool. | Query scope. {ok: true, deletedCount}. 404 not found in this pool when nothing matched; 403 as above. |
| GET | /api/memory/captures |
This org’s capture-outbox rows and their delivery state. | {captures}. delivering orphans surface here for manual recovery. |
| POST | /api/memory/captures/:runId/retry |
Re-enqueue a dead capture (fresh attempt budget). | {ok: true}. 404 no dead capture for this run in your org. |
| POST | /api/memory/captures/:runId/resolve |
Resolve a crash-orphaned delivering capture, at most once. |
Body: resolution ("delivered" or "discard", required). {ok: true}. 404 no delivering orphan for this run in your org. |
| GET | /api/memory/recalls |
Per-run recall frames from the retrieval ledger. | {recalls}, each linking back to its session. |