Referência da REST API

Todos os endpoints requerem um token Bearer. Obtenha seu token no painel.

# URL Base

https://api.agent-memo.ai

# Cabeçalho de autenticação

Authorization: Bearer YOUR_API_KEY

Memórias

GET/api/memories

Listar memórias com filtros opcionais

Query: ?topic=&type=&importance=&limit=&offset=

POST/api/memories

Criar uma nova memória

{ "content": "...", "type": "project", "topic": "auth", "importance": 2, "tags": ["decision"] }

GET/api/memories/:id

Obter uma memória por ID

PUT/api/memories/:id

Atualizar uma memória existente

{ "content": "updated content", "importance": 3 }

DELETE/api/memories/:id

Excluir uma memória

POST/api/memories/search

Busca semântica entre memórias

{ "query": "database choice", "type": ["project"], "limit": 5 }

GET/api/memories/topics

Listar todos os tópicos com contagem de memórias

POST/api/memories/check-duplicate

Verificar duplicatas semânticas antes de armazenar

{ "content": "...", "threshold": 0.92 }

Grafo de Conhecimento

POST/api/kg/add

Adicionar um relacionamento de entidade (fato)

{ "subject": "auth-service", "predicate": "uses", "object": "JWT", "confidence": 0.95 }

POST/api/kg/query

Consultar relacionamentos de entidades

{ "entity": "auth-service", "direction": "outgoing" }

POST/api/kg/invalidate

Invalidar um fato (marcar como não mais verdadeiro)

{ "factId": "..." }

POST/api/kg/timeline

Ver linha do tempo de fatos para uma entidade

{ "entity": "auth-service" }

GET/api/kg/stats

Estatísticas do grafo de conhecimento

Formato de resposta

Todas as respostas são JSON. Respostas bem-sucedidas retornam os dados diretamente. Erros retornam um objeto JSON com um campo error.

Sucesso (200)

{
  "id": "abc-123",
  "content": "Use PostgreSQL",
  "type": "project",
  "topic": "database",
  "importance": 3,
  "created_at": "2026-04-08T..."
}

Erro (4xx/5xx)

{
  "error": "Memory not found"
}

Limites de taxa

Durante o beta, não há limites de taxa aplicados. Seja um bom cidadão — o uso típico fica bem abaixo de 100 requisições/minuto. Limites de taxa serão introduzidos com os planos pagos.