# FAQ da API
SUMMARY: Perguntas comuns sobre a API — autenticação, limites de taxa, tratamento de erros, descoberta de endpoints.

FAQ da API
Perguntas comuns sobre a API do Synapse.
Como faço para autenticar?
Dois métodos:
1. Mind Key (para endpoints de dados): 
2. JWT (para endpoints de conta): 
Ou via parâmetro de consulta (limite de 60 req/min): 
Consulte Autenticação.
Qual a diferença entre Mind Key e JWT?
- Mind Key: escopo de tenant, nunca expira, para dados de memória/chat/tarefas
- JWT: escopo de usuário, expira em 7 dias, para gerenciamento de conta/mind
Consulte Mind Key vs JWT.
Por que estou recebendo 401 Unauthorized?
Causas comuns:
1. Cabeçalho  ausente
2. Mind Key inválida (verifique se começa com )
3. Usando JWT onde Mind Key é necessária (ou vice-versa)
4. Mind Key foi revogada
Correção: Verifique seu token. Consulte Autenticação.
Por que estou recebendo 404 Not Found?
Você usou um caminho de endpoint errado. O Synapse só tem os caminhos listados
em .
Correção: Chame  para ver todos os caminhos válidos. Não
adivinhe.
Por que estou recebendo 429 Too Many Requests?
Você está usando auth via parâmetro de consulta , que é limitada a 60/min.
Correção: Mude para o cabeçalho  (sem limite de
taxa).
Consulte Limites de taxa.
Como listo todos os endpoints?
[CODE BLOCK]
Como encontro o endpoint certo?
1. Confira  para a lista legível por máquina
2. Confira  para a documentação completa da API
3. Navegue em  para o sistema de documentação
4. Use  para a especificação OpenAPI 3.0
Posso usar GET em vez de POST?
Alguns endpoints POST têm equivalentes GET para ferramentas somente-URL:
-  ↔ 
-  ↔ 
-  ↔ 
Confira  para variantes GET disponíveis.
Como trato erros?
Todos os erros retornam JSON:
[CODE BLOCK]
Consulte Erros e tratamento de erros.
Qual o limite do corpo da requisição?
10 MB. Para payloads maiores (ex.: upload de arquivos), use os endpoints
multipart.
A API suporta CORS?
Sim. Todos os endpoints retornam:
[CODE BLOCK]
Existe um SDK?
Sim:
- Node.js: 
- MCP: 
Consulte Visão geral da API para detalhes.
Como faço paginação?
Use  e :
[CODE BLOCK]
Limite padrão: 100. Máximo: 500.
Posso filtrar memórias por categoria ou tag?
Sim:
[CODE BLOCK]
Como faço busca de memórias?
De duas formas:
1. Busca por palavras-chave FTS5: 
2. Busca semântica: 
Consulte Busca FTS5 e Busca semântica.
Como atualizo uma memória?
Faça POST  com a mesma  +  — a memória existente é
atualizada, não duplicada.
[CODE BLOCK]
Como excluo uma memória?
[CODE BLOCK]
Posso excluir em massa?
Sim:
[CODE BLOCK]
Próximos passos
- Visão geral da API
- Erros e tratamento de erros
- Autenticação