Memory API

Contexto estruturado de entidades via graph (FalkorDB) e banco relacional (PostgreSQL).

A Memory API expõe o conteúdo do produto Memory da strattum.ai: perfis consolidados de entidades, timelines de eventos, contexto de grafo e contexto Markdown pronto para injeção em agentes de IA.

Base URL

http://localhost:8002

Em produção, o endereço é configurado no deployment BYOC do cliente.

Autenticação

A versão 1.0 não exige autenticação — o acesso é controlado pela rede privada do cliente (VPC/VLAN). Autenticação via API key está prevista no roadmap.

Serviços de infraestrutura

Serviço	Papel
PostgreSQL 16	entity_registry e entity_source_mapping
FalkorDB	Grafo de relações e eventos (:Entity, :Event, :HAD_EVENT)

Endpoints

GET /entity/{entity_id}

Perfil completo da entidade (golden record + source map).

GET /entity/{entity_id}/timeline

Timeline de eventos paginada e filtrável.

GET /entity/{entity_id}/graph

Nós e relacionamentos vizinhos no grafo FalkorDB.

GET /entity/{entity_id}/sources

Proveniência de dados — quais sistemas contribuíram.

GET /entity/{entity_id}/context

Contexto Markdown assembled, pronto para o agente.

POST /search

Busca entidades por email, nome, telefone ou texto livre.