Learning insights
List, create, and delete user-scoped learning insights for Ala personalization.
Learning insight routes back the store described in Learning mode. Insights are scoped to (orgId, userId) — callers only see their own rows.
Endpoints
| Method | Path | Description |
|---|---|---|
GET | /api/v1/learning | List insights (category, q, cursor pagination via cursor + pageSize). |
POST | /api/v1/learning | Create an insight (category, insight, optional source, confidence, metadata). |
DELETE | /api/v1/learning/:id | Delete one insight owned by the caller. |
Categories
category must be one of the platform learning categories (role, preferences, workflow, tools, goals, communication style, domain knowledge, pain points, other). Invalid categories return 400.
Pagination
GET /api/v1/learning returns { items, nextCursor, hasMore, total, categoryCounts }. The first page includes total and per-category counts; subsequent cursor pages omit them.
Default pageSize is 50 (max 200). Filter with category and full-text q against the insight body.
Dashboard
Review and delete insights at /<orgSlug>/learning. Ala also writes insights passively through the save_learning_insight tool during conversation when learning mode is enabled.