# FAQ API
SUMMARY: Questions courantes sur l'API — auth, limites de débit, gestion des erreurs, découverte d'endpoints.

FAQ API
Questions courantes sur l'API Synapse.
Comment m'authentifier ?
Deux méthodes :
1. Mind Key (pour les endpoints de données) : 
2. JWT (pour les endpoints de compte) : 
Ou via paramètre de requête (limite 60 req/min) : 
Voir Authentification.
Quelle est la différence entre Mind Key et JWT ?
- Mind Key : limitée au tenant, n'expire jamais, pour les données memory/chat/tasks
- JWT : limitée à l'utilisateur, expire en 7 jours, pour la gestion compte/mind
Voir Mind Key vs JWT.
Pourquoi est-ce que je reçois 401 Unauthorized ?
Causes courantes :
1. En-tête  manquant
2. Mind Key invalide (vérifiez qu'elle commence par )
3. Utilisation d'un JWT là où une Mind Key est requise (ou inversement)
4. La Mind Key a été révoquée
Correction : Vérifiez votre jeton. Voir Authentification.
Pourquoi est-ce que je reçois 404 Not Found ?
Vous avez utilisé un mauvais chemin d'endpoint. Synapse ne possède que les chemins
listés dans .
Correction : Appelez  pour voir tous les chemins valides. Ne
devinez pas.
Pourquoi est-ce que je reçois 429 Too Many Requests ?
Vous utilisez l'authentification par paramètre de requête , qui est limitée à
60/min.
Correction : Passez à l'en-tête  (sans limite de débit).
Voir Limites de débit.
Comment lister tous les endpoints ?
[CODE BLOCK]
Comment trouver le bon endpoint ?
1. Vérifiez  pour la liste lisible par machine
2. Vérifiez  pour la documentation complète de l'API
3. Parcourez  pour le système de documentation
4. Utilisez  pour la spécification OpenAPI 3.0
Puis-je utiliser GET au lieu de POST ?
Certains endpoints POST ont des équivalents GET pour les outils n'utilisant que des
URLs :
-  ↔ 
-  ↔ 
-  ↔ 
Vérifiez  pour les variantes GET disponibles.
Comment gérer les erreurs ?
Toutes les erreurs renvoient du JSON :
[CODE BLOCK]
Voir Erreurs & gestion des erreurs.
Quelle est la limite de corps de requête ?
10 Mo. Pour les payloads plus volumineux (ex. envoi de fichiers), utilisez les
endpoints multipart.
L'API prend-elle en charge CORS ?
Oui. Tous les endpoints renvoient :
[CODE BLOCK]
Y a-t-il un SDK ?
Oui :
- Node.js : 
- MCP : 
Voir Vue d'ensemble de l'API pour plus de détails.
Comment paginer ?
Utilisez  et  :
[CODE BLOCK]
Limite par défaut : 100. Max : 500.
Puis-je filtrer les mémoires par catégorie ou tag ?
Oui :
[CODE BLOCK]
Comment rechercher des mémoires ?
Deux façons :
1. Recherche par mots-clés FTS5 : 
2. Recherche sémantique : 
Voir Recherche FTS5 et Recherche sémantique.
Comment mettre à jour une mémoire ?
POST  avec la même  +  — la mémoire existante est mise à
jour, pas dupliquée.
[CODE BLOCK]
Comment supprimer une mémoire ?
[CODE BLOCK]
Puis-je supprimer en masse ?
Oui :
[CODE BLOCK]
Prochaines étapes
- Vue d'ensemble de l'API
- Erreurs & gestion des erreurs
- Authentification