API Reference.

Returns engine health status, version, uptime, and database stats.

Ingests a conversation exchange. The LLM extracts structured memories, runs dedup, and stores results. Body: { entity_id, content, source?, session_id?, agent_id?, schema_id?, team_id?, visibility? }.

Insert memories directly without LLM extraction. Useful for testing, migration, and bootstrapping. Body: { memories: [{ entity_id, content, type, importance?, ... }] }.

Semantic search over stored memories. Body: { entity_id, query, limit?, mode?, agent_id?, team_aware?, min_score? }. Returns ranked results with similarity scores.

List all memories for an entity. Query params: entity_id, type?, state?, limit?, offset?. Returns paginated results.

Fetch a single memory by ID. Returns the full memory object including metadata, embedding status, and access history.

Soft-delete a memory by ID. Sets state to DELETED. Memory is purged after retention period (default 90 days).

Bulk delete memories for an entity. Query params: entity_id, type?, before?. Use with caution.

Update tags on a memory. Body: { tags: string[] }. Replaces existing tags.

Returns a random sample of memories for an entity. Query params: entity_id, limit?. Useful for debugging and testing.

Global engine statistics: total memories, entities, memory type distribution, storage size, HNSW index stats.

Per-entity statistics: memory count by type, average importance, decay distribution, relationship count, last activity.

Run the heartbeat signal scan. Body: { entity_id, deadline_window?, decay_threshold?, importance_floor?, max_results?, agent_id?, team_id? }. Returns { should_act, pending_work, deadlines, scheduled, decaying, conflicts, summary }.

Combined heartbeat check + context-relevant memory search in a single call. Body: { entity_id, query?, top_k?, min_score?, autonomy?, analyze?, agent_id?, in_conversation? }. Returns heartbeat signals plus relevant memories.

Record the actual message text sent in a heartbeat for dedup tracking. Body: { entity_id, agent_id, action_id?, message }.

Create a scheduled reminder. Body: { entity_id, content, cron_expression?, trigger_at?, repeat? }.

List scheduled items. Query params: entity_id?, active_only?. Returns all scheduled reminders with next trigger time.

Acknowledge a triggered schedule. Body: { schedule_id }. Prevents re-triggering for one-shot schedules.

Update a scheduled item. Body: { content?, cron_expression?, trigger_at?, active? }.

Delete a scheduled item permanently.

Returns the current watcher state including running status, adaptive mode, watched entities, and next tick time.

Returns the tick history ring buffer for auditing. Shows recent heartbeat check results and timing.

Start the heartbeat watcher loop. Body: { entity_ids, interval_ms?, adaptive?, delivery? }. Begins polling for watched entities.

Stop the heartbeat watcher loop. No more automatic heartbeat checks until restarted.

Add an entity to the watch list. Body: { entity_id }. The watcher will include this entity in heartbeat scans.

Remove an entity from the watch list. Body: { entity_id }. Stops heartbeat scanning for this entity.

Create a new team. Body: { name, description? }. Returns team ID.

Get team details including member list, shared memory count, and team stats.

Delete a team. Does not delete member entities or their memories.

Add a member to a team. Body: { agent_id, role? }. Members share team-scoped memories.

Remove a member from a team. Their personal memories are unaffected.

List all members of a team with their roles and join dates.

List all known entities (people, orgs, locations, products) and their relationship graph. Query params: type?, limit?.

Trigger memory consolidation for an entity. Merges near-duplicates, resolves conflicts, and rebuilds the HNSW index. Body: { entity_id }.

Server-Sent Events stream. Real-time notifications for memory changes, heartbeat signals, and watcher events. Connect with EventSource.