# API-FAQ
SUMMARY: Häufige API-Fragen — Auth, Rate Limits, Fehlerbehandlung, Endpunkt-Discovery.

API-FAQ
Häufige Fragen zur Synapse-API.
Wie authentifiziere ich mich?
Zwei Methoden:
1. Mind Key (für Daten-Endpunkte): 
2. JWT (für Konto-Endpunkte): 
Oder via Query-Parameter (60 req/min Limit): 
Siehe Authentifizierung.
Was ist der Unterschied zwischen Mind Key und JWT?
- Mind Key: Tenant-scoped, läuft nie ab, für Memory-/Chat-/Tasks-Daten
- JWT: Nutzer-scoped, 7-Tage-Ablauf, für Konto-/Mind-Verwaltung
Siehe Mind Key vs JWT.
Warum erhalte ich 401 Unauthorized?
Häufige Ursachen:
1. Fehlender -Header
2. Ungültiger Mind Key (prüfen, ob er mit  beginnt)
3. JWT verwendet, wo Mind Key erforderlich ist (oder umgekehrt)
4. Mind Key wurde widerrufen
Lösung: Token überprüfen. Siehe Authentifizierung.
Warum erhalte ich 404 Not Found?
Du hast einen falschen Endpunkt-Pfad verwendet. Synapse hat nur die Pfade, die in
 gelistet sind.
Lösung: Rufe  auf, um alle gültigen Pfade zu sehen. Nicht
raten.
Warum erhalte ich 429 Too Many Requests?
Du verwendest -Query-Parameter-Auth, die auf 60/min begrenzt ist.
Lösung: Wechsle zum -Header (kein Rate Limit).
Siehe Rate Limits.
Wie liste ich alle Endpunkte auf?
[CODE BLOCK]
Wie finde ich den richtigen Endpunkt?
1. Prüfe  für die maschinenlesbare Liste
2. Prüfe  für die vollständige API-Doku
3. Durchsuche  für das Dokumentationssystem
4. Verwende  für die OpenAPI-3.0-Spec
Kann ich GET statt POST verwenden?
Einige POST-Endpunkte haben GET-Äquivalente für reine URL-Tools:
-  ↔ 
-  ↔ 
-  ↔ 
Prüfe  für verfügbare GET-Varianten.
Wie behandle ich Fehler?
Alle Fehler liefern JSON:
[CODE BLOCK]
Siehe Errors & Fehlerbehandlung.
Wie hoch ist das Request-Body-Limit?
10 MB. Für größere Payloads (z. B. Datei-Uploads) verwende die Multipart-
Endpunkte.
Unterstützt die API CORS?
Ja. Alle Endpunkte liefern:
[CODE BLOCK]
Gibt es ein SDK?
Ja:
- Node.js: 
- MCP: 
Siehe API-Übersicht für Details.
Wie paginiere ich?
Verwende  und :
[CODE BLOCK]
Standard-Limit: 100. Max: 500.
Kann ich Memories nach Kategorie oder Tag filtern?
Ja:
[CODE BLOCK]
Wie durchsuche ich Memories?
Zwei Wege:
1. FTS5-Keyword-Suche: 
2. Semantische Suche: 
Siehe FTS5-Suche und Semantische Suche.
Wie aktualisiere ich einen Memory?
POST  mit derselben  +  — der bestehende Memory wird
aktualisiert, nicht dupliziert.
[CODE BLOCK]
Wie lösche ich einen Memory?
[CODE BLOCK]
Kann ich Bulk-löschen?
Ja:
[CODE BLOCK]
Nächste Schritte
- API-Übersicht
- Errors & Fehlerbehandlung
- Authentifizierung