# API-overzicht & Base URL
SUMMARY: Alle Synapse API-eindpunten, base URL, auth-patronen en responsformaten in één oogopslag.

KEY CONTEXT:
Base URL: https://synapse.schaefer.zone
Auth: Authorization: Bearer YOUR_MIND_KEY (header, no rate limit)
      OR ?key=YOUR_MIND_KEY (query, 60 req/min)
All responses are JSON except /memory/recall (text/plain) and /docs (HTML/text/json)
All 404 responses mean the path does not exist — do NOT guess paths.
GET /endpoints returns machine-readable list of all valid endpoints.

API-overzicht & Base URL
De Synapse API is een RESTful HTTP-API. Alle eindpunten retourneren JSON (behalve waar
vermeld). Deze pagina behandelt de essentiële zaken voordat u naar specifieke
eindpunten duikt.
Base URL
[CODE BLOCK]
Alle paden in deze documentatie zijn relatief ten opzichte van deze base URL. Voor
self-hosted instanties vervangt u dit door uw eigen URL.
Authenticatie
Twee methoden, beide via de -header:
[CODE BLOCK]
Of via queryparameter (ratelimited tot 60/min):
[CODE BLOCK]
Zie Authenticatie voor details.
Eindpuntgroepen
| Groep | Auth | Beschrijving |
|-------|------|--------------|
| Public | Geen | Landingspagina, health, OpenAPI, docs |
| Memory | Mind Key | CRUD, zoeken, synchroniseren, embeddings |
| Chat | Mind Key / JWT | Asynchrone berichtenuitwisseling tussen mens en agent |
| Tasks | Mind Key | Taakbeheer |
| Scripts | Mind Key / JWT | Permanente script-opslag |
| Scheduler | Mind Key | Cron-jobs + variabelen |
| Webhooks | Mind Key | HTTP-callbacks bij gebeurtenissen |
| Computers | Mind Key / JWT | Bediening van computers op afstand |
| User/Minds | JWT | Account + mind-beheer |
| Sharing | JWT | Mind delen tussen gebruikers |
| Push | JWT | Web Push-abonnementen |
| Tools | Geen | Tijd, calc, random (openbare hulpmiddelen) |
Responsformaten
- JSON (standaard): 
- Platte tekst:  retourneert op LLM geoptimaliseerde tekst
- HTML: , , , , 
Standaard respons-envelope
Succesresponsen retourneren de data direct:
[CODE BLOCK]
Foutresponsen gebruiken dit formaat:
[CODE BLOCK]
> [!NOTE]
> Het -veld verwijst naar relevante documentatie voor veelvoorkomende fouten.
HTTP-statuscodes
| Code | Betekenis |
|------|-----------|
| 200 | Succes (GET, PUT) |
| 201 | Aangemaakt (POST) |
| 204 | Geen inhoud (DELETE) |
| 400 | Onjuist verzoek (validatiefout) |
| 401 | Niet-geautoriseerd (ontbrekend/ongeldig token) |
| 403 | Verboden (verkeerd tokentype) |
| 404 | Niet gevonden (pad bestaat niet) |
| 409 | Conflict (dubbeling) |
| 429 | Te veel verzoeken (ratelimit) |
| 500 | Serverfout |
Ontdekkings-eindpunten
| Eindpunt | Doel |
|----------|------|
|  | Landingspagina (op LLM geoptimaliseerd) |
|  | Machineleesbare lijst van alle eindpunten |
|  | Plattetekst eindpuntlijst |
|  | OpenAPI 3.0-specificatie |
|  | Volledige API-documentatie (HTML) |
|  | API-documentatie als JSON |
|  | Documentatiesysteem (HTML) |
|  | Documentatie-index (JSON) |
|  | Alle documentatie als één tekstblok |
|  | Interactieve API-playground |
Ratelimits
| Auth-methode | Limiet |
|--------------|--------|
| Mind Key (header) | Geen |
| Mind Key (?key=) | 60/min per IP |
| JWT (header) | Geen |
| Openbare eindpunten | Geen |
Ratelimited responsen bevatten:
[CODE BLOCK]
Paginering
Lijst-eindpunten ondersteunen  en :
[CODE BLOCK]
Standaardlimiet: 100. Maximale limiet: 500.
CORS
Alle eindpunten ondersteunen CORS voor browser-gebaseerde clients:
[CODE BLOCK]
SDK's & Clients
- Node.js SDK:  (repo)
- MCP Server:  (repo)
- HTTP-client: elke HTTP-bibliotheek (curl, fetch, axios, enz.)
Volgende stappen
- Memory API — de belangrijkste eindpunten
- Chat API — asynchrone communicatie tussen mens en agent
- Fouten & Foutafhandeling