# Ikhtisar API & Base URL
SUMMARY: Semua endpoint API Synapse, base URL, pola autentikasi, dan format respons dalam sekali pandang.

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.

Ikhtisar API & Base URL
Synapse API adalah HTTP API yang RESTful. Semua endpoint mengembalikan JSON
(kecuali jika dicatat). Halaman ini mencakup hal-hal penting yang perlu Anda
ketahui sebelum mendalami endpoint tertentu.
Base URL
[CODE BLOCK]
Semua path dalam dokumentasi ini relatif terhadap base URL ini. Untuk instansi
self-hosted, ganti dengan URL Anda sendiri.
Autentikasi
Dua metode, keduanya dikirim melalui header :
[CODE BLOCK]
Atau melalui parameter query (rate-limited ke 60/menit):
[CODE BLOCK]
Lihat Autentikasi untuk detailnya.
Grup Endpoint
| Grup | Auth | Deskripsi |
|-------|------|-------------|
| Public | Tidak ada | Landing page, health, OpenAPI, docs |
| Memory | Mind Key | CRUD, pencarian, sinkronisasi, embeddings |
| Chat | Mind Key / JWT | Pesan asinkron antara manusia dan agen |
| Tasks | Mind Key | Manajemen tugas |
| Scripts | Mind Key / JWT | Penyimpanan skrip persisten |
| Scheduler | Mind Key | Cron jobs + variabel |
| Webhooks | Mind Key | HTTP callback pada event |
| Computers | Mind Key / JWT | Kontrol komputer remote |
| User/Minds | JWT | Akun + manajemen mind |
| Sharing | JWT | Berbagi mind antar pengguna |
| Push | JWT | Langganan Web Push |
| Tools | Tidak ada | Waktu, kalkulator, acak (utilitas publik) |
Format Respons
- JSON (default): 
- Teks polos:  mengembalikan teks yang dioptimalkan untuk LLM
- HTML: , , , , 
Amplop Respons Standar
Respons sukses mengembalikan data secara langsung:
[CODE BLOCK]
Respons error menggunakan format ini:
[CODE BLOCK]
> [!NOTE]
> Field  menautkan ke dokumentasi terkait untuk error umum.
Kode Status HTTP
| Kode | Arti |
|------|---------|
| 200 | Sukses (GET, PUT) |
| 201 | Created (POST) |
| 204 | No content (DELETE) |
| 400 | Bad request (error validasi) |
| 401 | Unauthorized (token tidak ada/tidak valid) |
| 403 | Forbidden (tipe token salah) |
| 404 | Not found (path tidak ada) |
| 409 | Conflict (duplikat) |
| 429 | Too many requests (rate limit) |
| 500 | Server error |
Endpoint Discoverability
| Endpoint | Tujuan |
|----------|---------|
|  | Landing page (dioptimalkan untuk LLM) |
|  | Daftar yang dapat dibaca mesin dari semua endpoint |
|  | Daftar endpoint teks polos |
|  | Spesifikasi OpenAPI 3.0 |
|  | Dokumentasi API lengkap (HTML) |
|  | Dokumentasi API sebagai JSON |
|  | Sistem dokumentasi (HTML) |
|  | Indeks dokumentasi (JSON) |
|  | Semua dokumentasi sebagai satu blok teks |
|  | Playground API interaktif |
Rate Limits
| Metode Auth | Batas |
|-------------|-------|
| Mind Key (header) | Tidak ada |
| Mind Key (?key=) | 60/menit per IP |
| JWT (header) | Tidak ada |
| Endpoint publik | Tidak ada |
Respons yang di-rate-limit menyertakan:
[CODE BLOCK]
Paginasi
Endpoint daftar mendukung  dan :
[CODE BLOCK]
Limit default: 100. Limit maksimum: 500.
CORS
Semua endpoint mendukung CORS untuk klien berbasis browser:
[CODE BLOCK]
SDK & Klien
- Node.js SDK:  (repo)
- MCP Server:  (repo)
- HTTP client: pustaka HTTP apa pun (curl, fetch, axios, dll.)
Langkah Berikutnya
- Memory API — endpoint terpenting
- Chat API — komunikasi asinkron manusia-agen
- Errors & Error Handling