Skip to main content
Start the MemWire server: 
cd api
docker compose up --build -d   # Qdrant + MemWire on :8000
Base URL: http://localhost:8000 Interactive docs: http://localhost:8000/docs

​
Store memory

POST /v1/memory 
curl -X POST http://localhost:8000/v1/memory \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "alice",
    "app_id": "app_a",
    "workspace_id": "team_1",
    "messages": [
      { "role": "user", "content": "I prefer dark mode and short answers." }
    ]
  }'

{
  "stored": 1,
  "memory_ids": ["mem_3f7a1c2d9e4b"]
}

​
Recall context

POST /v1/memory/recall 
curl -X POST http://localhost:8000/v1/memory/recall \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "alice",
    "app_id": "app_a",
    "workspace_id": "team_1",
    "query": "How should I format my answers?",
    "top_k": 5
  }'

{
  "context": "alice prefers dark mode and short answers.",
  "paths": 2,
  "knowledge": []
}

​
Search memories

POST /v1/memory/search 
curl -X POST http://localhost:8000/v1/memory/search \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "alice",
    "query": "dark mode",
    "top_k": 10
  }'

{
  "results": [
    {
      "memory_id": "mem_3f7a1c2d9e4b",
      "content": "I prefer dark mode and short answers.",
      "category": "preference",
      "score": 0.94
    }
  ]
}