> ## Documentation Index
> Fetch the complete documentation index at: https://strattumai.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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

<CardGroup cols={2}>
  <Card title="GET /entity/{entity_id}" icon="user" href="/api-reference/memory/get-entity">
    Perfil completo da entidade (golden record + source map).
  </Card>

  <Card title="GET /entity/{entity_id}/timeline" icon="clock" href="/api-reference/memory/get-timeline">
    Timeline de eventos paginada e filtrável.
  </Card>

  <Card title="GET /entity/{entity_id}/graph" icon="share-nodes" href="/api-reference/memory/get-graph">
    Nós e relacionamentos vizinhos no grafo FalkorDB.
  </Card>

  <Card title="GET /entity/{entity_id}/sources" icon="database" href="/api-reference/memory/get-sources">
    Proveniência de dados — quais sistemas contribuíram.
  </Card>

  <Card title="GET /entity/{entity_id}/context" icon="bolt" href="/api-reference/memory/get-context">
    Contexto Markdown assembled, pronto para o agente.
  </Card>

  <Card title="POST /search" icon="magnifying-glass" href="/api-reference/memory/search">
    Busca entidades por email, nome, telefone ou texto livre.
  </Card>
</CardGroup>