# Quick Start voor LLM-agents
SUMMARY: In 3 API-aanroepen: alle herinneringen ophalen, een nieuwe opslaan, zoeken. De essentiële LLM-workflow.

KEY CONTEXT:
Base URL: https://synapse.schaefer.zone
Auth: Authorization: Bearer YOUR_MIND_KEY (header, required — ?key= DISABLED by default, AUTH_QUERY_KEY_MODE=deny hardened default; 401 + hint)
ALWAYS call /memory/recall at the start of every session.
Wichtigste Befehle: GET /memory/recall, POST /memory, GET /memory/search?q=...
Categories: identity, preference, fact, project, skill, mistake, context, note, credentials
Priorities: low, normal, high, critical
FTS5 search: multiple words = AND, "phrases" in quotes, prefix* for prefix search

Quick Start voor LLM-agents
U verliest alle geheugen tussen sessies. Synapse is uw externe hersenen. Deze handleiding
toont de drie essentiële API-aanroepen die elke LLM-agent moet kennen.
> [!CRITICAL]
> Roep  aan aan het BEGIN van ELKE sessie.
> Zonder deze aanroep heeft u geen geheugen van wie de gebruiker is, wat u beloofd heeft,
> of waaraan u de laatste keer werkte.
Stap 1: Alle herinneringen ophalen (ALTIJD EERST)
[CODE BLOCK]
Retourneert een gestructureerde platte-tekst samenvatting van alle opgeslagen herinneringen. Parse dit om
uw mentale model van de gebruiker, hun projecten en eerdere interacties te herstellen.
Voorbeeldrespons:
[CODE BLOCK]
Stap 2: Een nieuwe herinnering opslaan
Wanneer u iets leert dat het onthouden waard is:
[CODE BLOCK]
Categorieën: , , , , , , , , 
Prioriteiten: , , , 
> [!TIP]
> Voeg altijd een -veld toe — een korte identificator voor de herinnering. Hiermee kunt u
> dezelfde herinnering later bijwerken door opnieuw te POSTen met dezelfde key.
Stap 3: Naar een specifieke herinnering zoeken
[CODE BLOCK]
> [!TIP]
> FTS5-syntaxis: meerdere woorden = AND-zoekopdracht. Zinnen tussen aanhalingstekens: .
> Prefix-zoekopdracht: . Booleaans: .
Open tools (geen auth-headers) — standaard uitgeschakeld
Als uw tool alleen URL's kan openen (geen aangepaste headers): de -parameter is
uitgeschakeld door de geharde standaardwaarde  — de API is
alleen Bearer en  antwoordt met 401 en de hint "Query-param auth (?key=) is disabled". Alleen als een operator
expliciet  instelt:
[CODE BLOCK]
> [!WARNING]
> Alleen in allow-modus is  gelimiteerd tot 60 verzoeken/minuut. Externe Bearer-clients krijgen
> 120 req/min per identiteit; vertrouwde interne netwerken zijn onbeperkt. Geef de voorkeur aan de Bearer-header.
Volledige sessie-workflow
1. Sessiestart:  — alle herinneringen laden
2. Tijdens werk:  — specifieke feiten vinden
3. Bij nieuwe info:  — opslaan (met categorie, key, tags, prioriteit)
4. Periodiek:  — menselijke berichten controleren
5. Sessie-einde: Sla eventuele laatste leermomenten op via 
Veelvoorkomende patronen
Een bestaande herinnering bijwerken
POST  met dezelfde  en  — de bestaande herinnering wordt
bijgewerkt, niet gedupliceerd.
Projectstatus opslaan
[CODE BLOCK]
Een fout vastleggen (zodat u deze niet herhaalt)
[CODE BLOCK]
Menselijke berichten controleren
[CODE BLOCK]
Retourneert ongelezen berichten van de mens. Antwoord met:
[CODE BLOCK]
Volgende stappen
- Authenticatie — Mind Key vs JWT
- Memory API-referentie — alle 22 memory-eindpunten
- Chat API — asynchrone communicatie met mensen
- LLM-cookbook — praktische patronen