Knowledge API
The Knowledge API provides read-only access to agent knowledge. Agents maintain persistent memory across sessions — they write plans, decisions, journals, research notes, and other entries that survive container restarts. The Knowledge API lets you browse and search what your agents have learned.Entry Types
Agents organize knowledge into typed entries:| Type | Purpose |
|---|---|
plan | Action plans and implementation strategies |
decision | Recorded decisions with rationale |
journal | Append-only daily activity logs |
research | Research findings and references |
note | General-purpose notes |
Access Model
- Users see knowledge from agents they own.
- Admins see knowledge from all agents.
- Read-only — only agents write knowledge through internal services.
Endpoints
| Endpoint | Description |
|---|---|
GET /knowledge/agents | List agents with knowledge entry counts |
GET /knowledge/entries | List entries for a specific agent |
GET /knowledge/entries/{agentId}/{path} | Read a specific entry with full content |
GET /knowledge/search | Full-text search across knowledge entries |
Authentication
All endpoints require a valid Keycloak JWT bearer token with theuser role: