# API-översikt & bas-URL
SUMMARY: Alla Synapse API-endpoints, bas-URL, autentiseringsmönster och svarsformat i korthet.

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-översikt & bas-URL
Synapse API är ett RESTful HTTP-API. Alla endpoints returnerar JSON (utom där
angivet). Den här sidan täcker det ni behöver veta innan ni dyker in i specifika
endpoints.
Bas-URL
[CODE BLOCK]
Alla sökvägar i denna dokumentation är relativa till denna bas-URL. För
självvärdda instanser, ersätt med er egen URL.
Autentisering
Två metoder, båda skickade via -header:
[CODE BLOCK]
Eller via queryparameter (hastighetsbegränsad till 60/min):
[CODE BLOCK]
Se Autentisering för detaljer.
Endpoint-grupper
| Grupp | Autentisering | Beskrivning |
|-------|------|-------------|
| Publik | Ingen | Landningssida, hälsa, OpenAPI, dokumentation |
| Memory | Mind Key | CRUD, sökning, synk, inbäddningar |
| Chat | Mind Key / JWT | Asynkrona meddelanden mellan människa och agent |
| Tasks | Mind Key | Uppgiftshantering |
| Scripts | Mind Key / JWT | Beständig skriptlagring |
| Scheduler | Mind Key | Cron-jobb + variabler |
| Webhooks | Mind Key | HTTP-återanrop vid händelser |
| Computers | Mind Key / JWT | Fjärrstyrning av datorer |
| User/Minds | JWT | Konto + mind-hantering |
| Sharing | JWT | Mind-delning mellan användare |
| Push | JWT | Web Push-prenumerationer |
| Tools | Ingen | Tid, kalkyl, slump (publika verktyg) |
Svarsformat
- JSON (standard): 
- Oformaterad text:  returnerar LLM-optimerad text
- HTML: , , , , 
Standard kuvert för svar
Lyckade svar returnerar datan direkt:
[CODE BLOCK]
Felsvar använder detta format:
[CODE BLOCK]
> [!NOTE]
> Fältet  länkar till relevant dokumentation för vanliga fel.
HTTP-statuskoder
| Kod | Betydelse |
|------|---------|
| 200 | Lyckades (GET, PUT) |
| 201 | Skapad (POST) |
| 204 | Inget innehåll (DELETE) |
| 400 | Felaktig begäran (valideringsfel) |
| 401 | Obehörig (saknas/ogiltig token) |
| 403 | Förbjuden (fel tokentyp) |
| 404 | Hittades inte (sökvägen finns inte) |
| 409 | Konflikt (dubblett) |
| 429 | För många begäranden (hastighetsgräns) |
| 500 | Serverfel |
Upptäckbarhets-endpoints
| Endpoint | Syfte |
|----------|---------|
|  | Landningssida (LLM-optimerad) |
|  | Maskinläsbar lista över alla endpoints |
|  | Ofärmaterad endpoint-lista |
|  | OpenAPI 3.0-specifikation |
|  | Fullständig API-dokumentation (HTML) |
|  | API-dokumentation som JSON |
|  | Dokumentationssystem (HTML) |
|  | Dokumentationsindex (JSON) |
|  | All dokumentation som ett textblock |
|  | Interaktiv API-playground |
Hastighetsgränser
| Autentiseringsmetod | Gräns |
|-------------|-------|
| Mind Key (header) | Ingen |
| Mind Key (?key=) | 60/min per IP |
| JWT (header) | Ingen |
| Publika endpoints | Ingen |
Hastighetsbegränsade svar inkluderar:
[CODE BLOCK]
Paginering
List-endpoints stöder  och :
[CODE BLOCK]
Standardgräns: 100. Maxgräns: 500.
CORS
Alla endpoints stöder CORS för webbläsarbaserade klienter:
[CODE BLOCK]
SDK:er & klienter
- Node.js SDK:  (repo)
- MCP Server:  (repo)
- HTTP-klient: valfritt HTTP-bibliotek (curl, fetch, axios, etc.)
Nästa steg
- Memory API — de viktigaste endpoints
- Chat API — asynkron kommunikation mellan människa och agent
- Fel & felhantering