# FAQ API
SUMMARY: Domande comuni sull'API — auth, rate limit, gestione errori, scoperta endpoint.

FAQ API
Domande comuni sull'API di Synapse.
Come mi autentico?
Due metodi:
1. Mind Key (per endpoint dati): 
2. JWT (per endpoint account): 
Oppure tramite parametro query (limite 60 req/min): 
Veda Autenticazione.
Qual è la differenza tra Mind Key e JWT?
- Mind Key: scope tenant, non scade mai, per dati memory/chat/tasks
- JWT: scope utente, scadenza 7 giorni, per gestione account/menti
Veda Mind Key vs JWT.
Perché ricevo 401 Unauthorized?
Cause comuni:
1. Header  mancante
2. Mind Key non valida (verifichi che inizi con )
3. Uso di un JWT dove è richiesta una Mind Key (o viceversa)
4. La Mind Key è stata revocata
Soluzione: Verifichi il suo token. Veda Autenticazione.
Perché ricevo 404 Not Found?
Ha usato un percorso endpoint errato. Synapse ha solo i percorsi elencati in
.
Soluzione: Chiami  per vedere tutti i percorsi validi. Non
indovini.
Perché ricevo 429 Too Many Requests?
Sta usando l'autenticazione tramite parametro query , che è limitata a
60/min.
Soluzione: Passi all'header  (nessun rate limit).
Veda Limiti di traffico.
Come elenco tutti gli endpoint?
[CODE BLOCK]
Come trovo l'endpoint giusto?
1. Verifichi  per la lista machine-readable
2. Verifichi  per la documentazione API completa
3. Navigi  per il sistema di documentazione
4. Usi  per la specifica OpenAPI 3.0
Posso usare GET invece di POST?
Alcuni endpoint POST hanno equivalenti GET per strumenti solo-URL:
-  ↔ 
-  ↔ 
-  ↔ 
Verifichi  per le varianti GET disponibili.
Come gestisco gli errori?
Tutti gli errori restituiscono JSON:
[CODE BLOCK]
Veda Errori e gestione degli errori.
Qual è il limite del corpo della richiesta?
10 MB. Per payload più grandi (es. caricamento file), usi gli endpoint
multipart.
L'API supporta CORS?
Sì. Tutti gli endpoint restituiscono:
[CODE BLOCK]
C'è un SDK?
Sì:
- Node.js: 
- MCP: 
Veda Panoramica API per i dettagli.
Come faccio la paginazione?
Usi  e :
[CODE BLOCK]
Limite predefinito: 100. Massimo: 500.
Posso filtrare le memorie per categoria o tag?
Sì:
[CODE BLOCK]
Come cerco nelle memorie?
In due modi:
1. Ricerca per parola chiave FTS5: 
2. Ricerca semantica: 
Veda Ricerca FTS5 e Ricerca semantica.
Come aggiorno una memoria?
POST  con la stessa  +  — la memoria esistente viene
aggiornata, non duplicata.
[CODE BLOCK]
Come elimino una memoria?
[CODE BLOCK]
Posso fare eliminazione bulk?
Sì:
[CODE BLOCK]
Prossimi passi
- Panoramica API
- Errori e gestione degli errori
- Autenticazione