Menu
REST API endpoint reference for the mempalace HTTP server
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Diagnose mempalace setup (config, palace path, MCP, FTS/index health)
List or inspect people/project entities tracked in the mempalace graph
Mine a project directory into the mempalace corpus (drawers, rooms, wings)
Hybrid search over the mempalace corpus (BM25 + vectors + optional graph)
Show mempalace palace status (drawers, wings, rooms, health)
Trace a file, function, or line back to the agent session that produced its current commit
| name | mempalace-rest-api |
| description | REST API endpoint reference for the mempalace HTTP server |
The REST API is served on port 6969 by default (MEMPALACE_HTTP_PORT). Start with mpr serve --http.
| Method | Path | Description |
|---|---|---|
| GET | /health | Simple health check |
| GET | /healthz | Full health report (requires health feature) |
| GET | /livez | Lightweight liveness probe |
| GET | /tools | List available tools |
| Method | Path | Description |
|---|---|---|
| GET | /memories | List memories |
| POST | /memories | Save a memory |
| GET | /memories/{id} | Get memory by ID |
| POST | /memories/{id} | Delete memory |
| Method | Path | Description |
|---|---|---|
| GET | /sessions | List sessions |
| GET | /commits | List commits |
| GET | /commits/{hash} | Look up commit |
| POST | /session/start | Start a session |
| POST | /session/end | End a session |
| Method | Path | Description |
|---|---|---|
| POST | /search | Search memories |
| POST | /smart_search | Hybrid BM25 + vector search |
| Method | Path | Description |
|---|---|---|
| POST | /kg/query | Query KG |
| POST | /kg/add | Add KG fact |
| POST | /kg/invalidate | Invalidate KG fact |
| GET | /kg/stats | KG statistics |
| POST | /kg/timeline | KG timeline |
| POST | /kg/traverse | Traverse KG |
| GET | /graph/stats | Graph statistics |
| POST | /graph/search | Graph search |
| POST | /graph/expand | Graph expand |
| Method | Path | Description |
|---|---|---|
| GET | /slots | List slots |
| POST | /slots | Create slot |
| GET | /slots/{id} | Get slot |
| POST | /slots/{id} | Delete slot |
| POST | /slots/{id}/append | Append to slot |
| POST | /slots/{id}/replace | Replace slot |
| Method | Path | Description |
|---|---|---|
| GET/POST | /sentinels | List/create sentinels |
| POST | /sentinels/{id} | Delete sentinel |
| POST | /sentinels/{id}/trigger | Trigger sentinel |
| GET/POST | /checkpoints | List/create checkpoints |
| POST | /checkpoints/{id}/resolve | Resolve checkpoint |
| GET/POST | /actions | List/create actions |
| POST | /actions/{id} | Update action |
POST /observe, POST /enrich, POST /consolidate, POST /reflect, POST /migrate, GET /status, POST /context/build, POST /timeline, POST /patterns, GET /audit, POST /relations, GET /profile, POST /skill/extract, POST /retention/score, GET /access/stats, POST /vision/search, POST /sketches, POST /session/start, POST /session/end, POST /summarize, POST /forget, POST /remember, GET /livez, GET /viewer/, POST /team/share, GET /team/feed, POST /lesson/save, GET /lesson/recall, POST /crystallize, POST /diagnose, POST /heal, POST /verify.
