Skip to main content

Lessons

Lessons are patterns the system learns to avoid repeating mistakes. These endpoints list, report, stat, and deactivate lessons for a user.

Base URL: http://localhost:3050

All request bodies are JSON (Content-Type: application/json). Field names on the raw HTTP prototype surface use snake_case.

GET /v1/memories/lessons​

List active lessons for a user.

Query params: user_id (required)

Response:

{
  "lessons": [
    { "id": "lesson-1", "pattern": "User dislikes verbose responses", "severity": "medium" }
  ],
  "count": 1
}

GET /v1/memories/lessons/stats​

Lesson statistics for a user.

Query params: user_id (required)

POST /v1/memories/lessons/report​

Report a new lesson/pattern.

Request:

{
  "user_id": "ethan",
  "pattern": "User prefers concise bullet points over prose",
  "source_memory_ids": ["cf3a5877-..."],
  "severity": "low"
}

Response:

{ "lessonId": "lesson-abc123" }

DELETE /v1/memories/lessons/:id​

Deactivate a lesson.

Query params: user_id (required)

Response:

{ "success": true }