REST API Reference
Base URL: http://localhost:8749/v1
Authentication
All endpoints require an API key passed as a Bearer token in the Authorization header.
Authorization: Bearer mn_live_abc123...
Engrams
POST
/engrams Store a new engram
{"concept":"...", "content":"...", "tags":[], "confidence": 0.9} GET
/engrams/:id Get engram by ID
PATCH
/engrams/:id Update engram fields
{"content":"...", "confidence": 0.95} DELETE
/engrams/:id Soft-delete (archive) an engram
GET
/engrams List engrams (filter by tags, state, limit)
Activation
POST
/activate Cognitive activation — primary retrieval endpoint
{"context":"...", "limit": 10, "min_score": 0.1, "tags":[], "include_why": true} POST
/search Full-text search only (no cognitive scoring)
{"query":"...", "limit": 20} Triggers
POST
/triggers Create a semantic trigger subscription
{"context":"...", "threshold": 0.8, "webhook_url":"..."} GET
/triggers List active triggers for this vault
DELETE
/triggers/:id Cancel a trigger subscription