{"title":"Ratelimits & Quota","slug":"rate-limits","category":"api","summary":"Ratelimit-beleid voor de Synapse API — Bearer-header (onbeperkt), ?key= (60/min), openbare eindpunten.","audience":["human","llm"],"tags":["api","rate-limits","quotas","throttling"],"difficulty":"beginner","updated":"2026-06-27","word_count":294,"read_minutes":1,"llm_context":"Mind Key (Authorization: Bearer header) → NO rate limit\nMind Key (?key= query param) → 60 req/min per IP\nJWT (Authorization: Bearer header) → NO rate limit\nPublic endpoints (/tools/*, /docs, /health, /endpoints) → NO rate limit\nRate limit headers: X-RateLimit-Limit, X-RateLimit-Remaining, Retry-After\nRecommendation: ALWAYS use Authorization header. Use ?key= only for URL-only tools.\n","lang":"nl","translated":true,"requested_lang":"nl","content_markdown":"\n# Ratelimits & Quota\n\nSynapse heeft een eenvoudig, voorspelbaar ratelimit-beleid dat is ontworpen om misbruik\nte voorkomen zonder legitiem gebruik in de weg te zitten.\n\n## Ratelimit-beleid\n\n| Auth-methode | Limiet | Bereik |\n|--------------|--------|--------|\n| Mind Key (`Authorization: Bearer`) | **Geen** | Per-mind |\n| Mind Key (`?key=`) | 60 aanvragen/min | Per-IP |\n| JWT (`Authorization: Bearer`) | **Geen** | Per-gebruiker |\n| Openbare eindpunten | **Geen** | Globaal |\n\n> [!TIP]\n> **Gebruik waar mogelijk altijd de `Authorization: Bearer`-header.** Deze heeft geen\n> ratelimit. Gebruik `?key=` alleen voor tools die geen custom headers kunnen instellen.\n\n## Ratelimit-headers\n\nWanneer u `?key=`-authenticatie gebruikt, bevatten responsen ratelimit-headers:\n\n```\nX-RateLimit-Limit: 60\nX-RateLimit-Remaining: 42\nX-RateLimit-Reset: 1782567840\n```\n\nWanneer u de limiet overschrijdt:\n\n```\nHTTP/1.1 429 Too Many Requests\nX-RateLimit-Limit: 60\nX-RateLimit-Remaining: 0\nRetry-After: 42\nContent-Type: application/json\n\n{\n \"statusCode\": 429,\n \"error\": \"Too Many Requests\",\n \"message\": \"Rate limit exceeded. Use Authorization header for unlimited access.\"\n}\n```\n\n## Als u een ratelimit raakt\n\nAls u een 429 krijgt:\n\n1. **Schakel over naar de Authorization-header** (aanbevolen):\n ```bash\n # Niet: ?key=YOUR_MIND_KEY (60/min limiet)\n curl \".../memory/recall?key=YOUR_MIND_KEY\"\n \n # Wel: Authorization-header (onbeperkt)\n curl -H \"Authorization: Bearer YOUR_MIND_KEY\" .../memory/recall\n ```\n\n2. **Of wacht `Retry-After` seconden** en probeer opnieuw.\n\n## Waarom de ?key= limiet bestaat\n\nDe `?key=`-queryparameter is handig voor URL-only tools (browsers,\n`open`-commando's), maar heeft beveiligings- en prestatie-implicaties:\n\n- **Beveiliging:** Queryparameters worden gelogd in server-accesslogs, browsergeschiedenis\n en Referer-headers. Beperking van gebruik verkleint de blootstelling.\n- **Prestaties:** Queryparameter-authenticatie vereist een IP-gebaseerde ratelimiter\n (Redis-lookup per verzoek), wat latency toevoegt. Header-authenticatie slaat dit over.\n- **Misbruikpreventie:** Een gelekte `?key=`-URL kan worden gedeeld en gebombardeerd.\n De IP-limiet beperkt de schade.\n\n## Aanbevolen patronen\n\n### LLM-agents\n\n```python\n# Always use header auth\nheaders = {\"Authorization\": f\"Bearer {MIND_KEY}\"}\nresponse = requests.get(f\"{URL}/memory/recall\", headers=headers)\n```\n\n### Browser-gebaseerde tools\n\nAls uw tool alleen URL's kan openen:\n\n```bash\n# OK voor incidenteel gebruik (onder 60/min)\nopen \"https://synapse.schaefer.zone/memory/recall?key=YOUR_MIND_KEY\"\n\n# Voor frequent gebruik, schakel over naar een tool die headers ondersteunt\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" .../memory/recall\n```\n\n### MCP-server\n\nMCP-servers gebruiken altijd header-authenticatie via de `SYNAPSE_MIND_KEY`-env-var —\ngeen ratelimit van toepassing.\n\n### Bulk-imports\n\nVoor bulkoperaties (bijv. 1000 herinneringen importeren), gebruik altijd header-authenticatie.\nBulk-imports via `?key=` raken de ratelimit binnen 1 minuut.\n\n## Quota (op mind-niveau)\n\nEr zijn momenteel geen per-mind quota voor opslaggrootte of aantal herinneringen. Alle\nlimieten zitten op het auth/IP-niveau, niet op dataniveau. Dit kan in de toekomst\nveranderen voor multi-tenant fairshare.\n\n## Uw gebruik monitoren\n\n```bash\n# Controleer uw huidige ratelimit-status (met ?key=-authenticatie)\ncurl -i \"https://synapse.schaefer.zone/memory/stats?key=YOUR_MIND_KEY\" | grep -i ratelimit\n\n# Output:\n# X-RateLimit-Limit: 60\n# X-RateLimit-Remaining: 58\n# X-RateLimit-Reset: 1782567840\n```\n\n## Volgende stappen\n\n- [Authenticatie](/docs/getting-started/authentication)\n- [Fouten & Foutafhandeling](/docs/api/errors)\n","content_html":"

Ratelimits & Quota

\n

Synapse heeft een eenvoudig, voorspelbaar ratelimit-beleid dat is ontworpen om misbruik\nte voorkomen zonder legitiem gebruik in de weg te zitten.

\n

Ratelimit-beleid

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Auth-methodeLimietBereik
Mind Key (Authorization: Bearer)GeenPer-mind
Mind Key (?key=)60 aanvragen/minPer-IP
JWT (Authorization: Bearer)GeenPer-gebruiker
Openbare eindpuntenGeenGlobaal
\n
**Gebruik waar mogelijk altijd de `Authorization: Bearer`-header.** Deze heeft geen\nratelimit. Gebruik `?key=` alleen voor tools die geen custom headers kunnen instellen.

Ratelimit-headers

\n

Wanneer u ?key=-authenticatie gebruikt, bevatten responsen ratelimit-headers:

\n
X-RateLimit-Limit: 60\nX-RateLimit-Remaining: 42\nX-RateLimit-Reset: 1782567840

Wanneer u de limiet overschrijdt:

\n
HTTP/1.1 429 Too Many Requests\nX-RateLimit-Limit: 60\nX-RateLimit-Remaining: 0\nRetry-After: 42\nContent-Type: application/json\n\n{\n  "statusCode": 429,\n  "error": "Too Many Requests",\n  "message": "Rate limit exceeded. Use Authorization header for unlimited access."\n}

Als u een ratelimit raakt

\n

Als u een 429 krijgt:

\n
    \n

  1. Schakel over naar de Authorization-header (aanbevolen):

    \n
    # Niet: ?key=YOUR_MIND_KEY (60/min limiet)\ncurl ".../memory/recall?key=YOUR_MIND_KEY"\n\n# Wel: Authorization-header (onbeperkt)\ncurl -H "Authorization: Bearer YOUR_MIND_KEY" .../memory/recall
    2. \n

  2. Of wacht Retry-After seconden en probeer opnieuw.

    \n
    3. \n
\n

Waarom de ?key= limiet bestaat

\n

De ?key=-queryparameter is handig voor URL-only tools (browsers,\nopen-commando's), maar heeft beveiligings- en prestatie-implicaties:

\n\n

Aanbevolen patronen

\n

LLM-agents

\n
# Always use header auth\nheaders = {"Authorization": f"Bearer {MIND_KEY}"}\nresponse = requests.get(f"{URL}/memory/recall", headers=headers)

Browser-gebaseerde tools

\n

Als uw tool alleen URL's kan openen:

\n
# OK voor incidenteel gebruik (onder 60/min)\nopen "https://synapse.schaefer.zone/memory/recall?key=YOUR_MIND_KEY"\n\n# Voor frequent gebruik, schakel over naar een tool die headers ondersteunt\ncurl -H "Authorization: Bearer YOUR_MIND_KEY" .../memory/recall

MCP-server

\n

MCP-servers gebruiken altijd header-authenticatie via de SYNAPSE_MIND_KEY-env-var —\ngeen ratelimit van toepassing.

\n

Bulk-imports

\n

Voor bulkoperaties (bijv. 1000 herinneringen importeren), gebruik altijd header-authenticatie.\nBulk-imports via ?key= raken de ratelimit binnen 1 minuut.

\n

Quota (op mind-niveau)

\n

Er zijn momenteel geen per-mind quota voor opslaggrootte of aantal herinneringen. Alle\nlimieten zitten op het auth/IP-niveau, niet op dataniveau. Dit kan in de toekomst\nveranderen voor multi-tenant fairshare.

\n

Uw gebruik monitoren

\n
# Controleer uw huidige ratelimit-status (met ?key=-authenticatie)\ncurl -i "https://synapse.schaefer.zone/memory/stats?key=YOUR_MIND_KEY" | grep -i ratelimit\n\n# Output:\n# X-RateLimit-Limit: 60\n# X-RateLimit-Remaining: 58\n# X-RateLimit-Reset: 1782567840

Volgende stappen

\n\n","urls":{"html":"/docs/api/rate-limits","text":"/docs/api/rate-limits?format=text","json":"/docs/api/rate-limits?format=json","llm":"/docs/api/rate-limits?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}