# Memory API
SUMMARY: Referensi lengkap untuk 22 endpoint memori: menyimpan, recall, pencarian, pencarian semantik, sinkronisasi, audit, dan lainnya.

KEY CONTEXT:
Auth: Mind Key (Authorization: Bearer mk_xxx OR ?key=mk_xxx)
ALWAYS call GET /memory/recall at session start.
POST /memory with same category+key updates the existing memory.
Categories: identity, preference, fact, project, skill, mistake, context, note, credentials
Priorities: low, normal, high, critical
Search: GET /memory/search?q=... (FTS5 syntax: AND, OR, "phrases", prefix*)
Semantic: GET /memory/semantic-search?q=... (slower, conceptual)
Sync: GET /memory/diff?since=TIMESTAMP (incremental sync)
Export: GET /memory/mind-export (full JSON dump)

Memory API
Memory API adalah jantung Synapse. API ini menyediakan 22 endpoint untuk
menyimpan, mengambil, mencari, dan mengelola memori terstruktur. Semua endpoint
memerlukan Mind Key untuk autentikasi.
> [!CRITICAL]
> Selalu panggil  di awal setiap sesi. Ini adalah
> satu-satunya cara untuk membangun kembali konteks dari sesi sebelumnya.
Kategori
Memori diorganisasi ke dalam 8 kategori:
| Kategori | Kasus Penggunaan |
|----------|----------|
|  | Nama pengguna, peran, info kontak, preferensi tentang diri sendiri |
|  | Suka, tidak suka, gaya kerja, preferensi komunikasi |
|  | Fakta yang dapat diverifikasi (detail proyek, tanggal, URL) |
|  | Status proyek, milestone, arsitektur |
|  | Hal-hal yang dikuasai pengguna |
|  | Error masa lalu — hindari pengulangan |
|  | Konteks yang relevan dengan sesi |
|  | Catatan lain-lain |
Prioritas
-  — bagus untuk diketahui
-  — default
-  — penting
-  — tidak boleh dilupakan (identitas pengguna, info hukum)
Endpoint Inti
GET /memory/recall
Mengembalikan SEMUA memori sebagai teks polos yang dioptimalkan untuk LLM. Panggil ini di setiap awal sesi.
[CODE BLOCK]
Respons (text/plain):
[CODE BLOCK]
POST /memory
Menyimpan memori baru atau memperbarui yang sudah ada (kategori + key yang sama = pembaruan).
[CODE BLOCK]
Respons: 
GET /memory
Mendaftar memori dengan filter opsional.
[CODE BLOCK]
PUT /memory/:id
Memperbarui memori tertentu berdasarkan ID.
[CODE BLOCK]
DELETE /memory/:id
Menghapus satu memori.
[CODE BLOCK]
Endpoint Pencarian
GET /memory/search
Pencarian teks penuh menggunakan FTS5.
[CODE BLOCK]
Sintaks FTS5:
- Beberapa kata = AND: 
- Frasa: 
- Prefix: 
- Boolean: 
- Pengecualian: 
GET /memory/semantic-search
Pencarian konseptual menggunakan embeddings (lebih lambat dari FTS5 tetapi memahami makna).
[CODE BLOCK]
Mengembalikan memori yang mirip secara semantik dengan kueri, meskipun tidak ada
kata kunci yang cocok. Berguna untuk "temukan memori tentang X" di mana X
dideskripsikan secara berbeda.
GET /memory/by-tag
Mendaftar memori berdasarkan tag.
[CODE BLOCK]
GET /memory/related/:id
Menemukan memori yang terkait dengan memori tertentu (melalui tag bersama).
[CODE BLOCK]
Sinkronisasi & Diff
GET /memory/diff
Sinkronisasi inkremental — mengembalikan memori yang berubah sejak timestamp tertentu.
[CODE BLOCK]
Respons: 
POST /memory/sync
Menerapkan diff dari instansi lain (untuk sinkronisasi self-hosted).
[CODE BLOCK]
Operasi Massal
POST /memory/bulk-delete
Menghapus beberapa memori berdasarkan ID.
[CODE BLOCK]
POST /memory/embed-batch
Membuat embeddings untuk memori yang belum memilikinya (untuk pencarian semantik).
[CODE BLOCK]
GET /memory/embed-batch-status
Memeriksa kemajuan pembuatan embedding.
[CODE BLOCK]
Verifikasi
Memori memiliki flag . Memori yang disimpan agen defaultnya tidak
terverifikasi (); memori yang disimpan manusia terverifikasi
().
POST /memory/verify
Menandai memori sebagai terverifikasi (memerlukan JWT, bukan Mind Key).
[CODE BLOCK]
POST /memory/unverify
Menandai memori sebagai tidak terverifikasi (memerlukan JWT).
[CODE BLOCK]
GET /memory/unverified
Mendaftar memori yang menunggu verifikasi manusia.
[CODE BLOCK]
Statistik & Audit
GET /memory/stats
Statistik agregat untuk mind saat ini.
[CODE BLOCK]
Mengembalikan: 
GET /memory/audit
Log audit dari semua operasi yang mengubah state.
[CODE BLOCK]
GET /memory/contradictions
Mendeteksi potensi kontradiksi dalam memori yang disimpan.
[CODE BLOCK]
GET /memory/expiring
Mendaftar memori dengan tanggal kedaluwarsa yang mendekat.
[CODE BLOCK]
Health & Export
GET /memory/health
Pemeriksaan health cepat untuk sistem memori.
[CODE BLOCK]
GET /memory/mind-export
Ekspor JSON lengkap dari semua memori (untuk backup).
[CODE BLOCK]
POST /memory/compact
Mengompak memori yang mirip (ringkasan otomatis).
[CODE BLOCK]
Langkah Berikutnya
- Quick Start untuk LLM
- Praktik Terbaik Memori
- Pencarian FTS5
- Pencarian Semantik