Knowledge Base API

The knowledge base is a per-project store of structured entries. Agents read it to understand architecture decisions, patterns, and gotchas before starting work.

List entries

GET /api/projects/:id/knowledge

Query params: category, tags, q (full-text search)

---

Create or update entry

PUT /api/projects/:id/knowledge/:key

{
  "title": "Database connection pattern",
  "content": "Always use the pool from AppState. Never open a direct connection.",
  "category": "pattern",
  "tags": ["database", "rust"]
}

key is a slug that uniquely identifies the entry within the project. Upserting the same key updates the entry.

Categories: architecture · pattern · gotcha · decision · reference

---

Get entry

GET /api/projects/:id/knowledge/:key

---

Delete entry

DELETE /api/projects/:id/knowledge/:key

---

Search

GET /api/projects/:id/knowledge/search?q=database&category=pattern