# API-FAQ
SUMMARY: Veelgestelde API-vragen — auth, ratelimits, foutafhandeling, eindpunt-ontdekking.

API-FAQ
Veelgestelde vragen over de Synapse API.
Hoe authenticeer ik?
Twee methoden:
1. Mind Key (voor data-eindpunten): 
2. JWT (voor account-eindpunten): 
Of via queryparameter (limiet van 60 aanvragen/min): 
Zie Authenticatie.
Wat is het verschil tussen Mind Key en JWT?
- Mind Key: tenant-scoped, vervalt nooit, voor memory/chat/tasks-data
- JWT: gebruiker-scoped, vervalt na 7 dagen, voor account/mind-beheer
Zie Mind Key vs JWT.
Waarom krijg ik 401 Unauthorized?
Veelvoorkomende oorzaken:
1. Ontbrekende -header
2. Ongeldige Mind Key (verifieer dat deze begint met )
3. Een JWT gebruiken waar een Mind Key vereist is (of omgekeerd)
4. Mind Key is ingetrokken
Oplossing: Verifieer uw token. Zie Authenticatie.
Waarom krijg ik 404 Not Found?
U heeft een verkeerd eindpuntpad gebruikt. Synapse heeft alleen de paden die in
 staan.
Oplossing: Roep  aan om alle geldige paden te zien. Raad niet.
Waarom krijg ik 429 Too Many Requests?
U gebruikt -queryparameter-auth, die is gelimiteerd tot 60/min.
Oplossing: Schakel over naar -header (geen ratelimit).
Zie Ratelimits.
Hoe toon ik alle eindpunten?
[CODE BLOCK]
Hoe vind ik het juiste eindpunt?
1. Controleer  voor de machineleesbare lijst
2. Controleer  voor volledige API-documentatie
3. Blader door  voor het documentatiesysteem
4. Gebruik  voor de OpenAPI 3.0-specificatie
Kan ik GET gebruiken in plaats van POST?
Sommige POST-eindpunten hebben GET-equivalenten voor URL-only tools:
-  ↔ 
-  ↔ 
-  ↔ 
Controleer  voor beschikbare GET-varianten.
Hoe handel ik fouten af?
Alle fouten retourneren JSON:
[CODE BLOCK]
Zie Fouten & Foutafhandeling.
Wat is de limiet voor requestbody's?
10 MB. Voor grotere payloads (bijv. bestandsuploads), gebruik de multipart-eindpunten.
Ondersteunt de API CORS?
Ja. Alle eindpunten retourneren:
[CODE BLOCK]
Is er een SDK?
Ja:
- Node.js: 
- MCP: 
Zie API-overzicht voor details.
Hoe pagineer ik?
Gebruik  en :
[CODE BLOCK]
Standaardlimiet: 100. Maximum: 500.
Kan ik herinneringen filteren op categorie of tag?
Ja:
[CODE BLOCK]
Hoe doorzoek ik herinneringen?
Twee manieren:
1. FTS5 trefwoordzoekopdracht: 
2. Semantisch zoeken: 
Zie FTS5-zoekopdracht en Semantisch zoeken.
Hoe werk ik een herinnering bij?
POST  met dezelfde  +  — de bestaande herinnering wordt
bijgewerkt, niet gedupliceerd.
[CODE BLOCK]
Hoe verwijder ik een herinnering?
[CODE BLOCK]
Kan ik in bulk verwijderen?
Ja:
[CODE BLOCK]
Volgende stappen
- API-overzicht
- Fouten & Foutafhandeling
- Authenticatie