# Memory API
SUMMARY: 22 bellek uç noktası için tam referans: saklama, geri çağırma, arama, anlamsal arama, senkronizasyon, denetim ve daha fazlası.

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, Synapse'un kalbidir. Yapılandırılmış bellekleri saklamak, almak, aramak ve yönetmek için 22 uç nokta sağlar. Tüm uç noktalar kimlik doğrulama için bir Mind Key gerektirir.
> [!CRITICAL]
> Her oturumun başında  çağrısını daima yapın. Bu, önceki oturumlardan bağlamı yeniden oluşturmanın tek yoludur.
Kategoriler
Bellekler 8 kategoriye ayrılmıştır:
| Kategori | Kullanım Senaryosu |
|----------|----------|
|  | Kullanıcı adı, rol, iletişim bilgisi, kendi hakkındaki tercihler |
|  | Beğeniler, beğenmemeler, çalışma tarzı, iletişim tercihleri |
|  | Doğrulanabilir bilgiler (proje detayları, tarihler, URL'ler) |
|  | Proje durumu, kilometre taşları, mimari |
|  | Kullanıcının iyi olduğu şeyler |
|  | Geçmiş hatalar — tekrarlamaktan kaçının |
|  | Oturumla ilgili bağlam |
|  | Çeşitli notlar |
Öncelikler
-  — bilmek güzel
-  — varsayılan
-  — önemli
-  — asla unutulmamalı (kullanıcı kimliği, yasal bilgiler)
Çekirdek Uç Noktalar
GET /memory/recall
Tüm bellekleri LLM için optimize edilmiş düz metin olarak döndürür. Her oturum başlangıcında çağırın.
[CODE BLOCK]
Yanıt (text/plain):
[CODE BLOCK]
POST /memory
Yeni bir bellek sakla veya mevcut olanı güncelle (aynı kategori + anahtar = güncelleme).
[CODE BLOCK]
Yanıt: 
GET /memory
İsteğe bağlı filtrelerle bellekleri listele.
[CODE BLOCK]
PUT /memory/:id
ID'ye göre belirli bir belleği güncelle.
[CODE BLOCK]
DELETE /memory/:id
Tek bir belleği sil.
[CODE BLOCK]
Arama Uç Noktaları
GET /memory/search
FTS5 kullanarak tam metin arama.
[CODE BLOCK]
FTS5 sözdizimi:
- Birden çok kelime = AND: 
- Deyim: 
- Ön ek: 
- Boolean: 
- Hariç tutma: 
GET /memory/semantic-search
Gömme (embedding) kullanarak kavramsal arama (FTS5'ten daha yavaştır ama anlamı anlar).
[CODE BLOCK]
Hiçbir anahtar kelime eşleşmese bile sorguya anlamsal olarak benzer bellekleri döndürür. X'in farklı şekilde tanımlandığı "X hakkındaki bellekleri bul" için yararlıdır.
GET /memory/by-tag
Etikete göre bellek listele.
[CODE BLOCK]
GET /memory/related/:id
Belirli bir bellekle ilgili bellekleri bul (paylaşılan etiketler aracılığıyla).
[CODE BLOCK]
Senkronizasyon & Diff
GET /memory/diff
Artımlı senkronizasyon — bir zaman damgasından sonraki değişen bellekleri döndürür.
[CODE BLOCK]
Yanıt: 
POST /memory/sync
Başka bir örnekten bir diff uygula (self-hosted senkronizasyon için).
[CODE BLOCK]
Toplu İşlemler
POST /memory/bulk-delete
ID'ye göre birden çok belleği sil.
[CODE BLOCK]
POST /memory/embed-batch
Henüz gömmeye sahip olmayan bellekler için gömme oluştur (anlamsal arama için).
[CODE BLOCK]
GET /memory/embed-batch-status
Gömme oluşturma ilerlemesini kontrol et.
[CODE BLOCK]
Doğrulama
Belleklerin bir  bayrağı vardır. Ajan tarafından saklanan bellekler varsayılan olarak doğrulanmamıştır (); insan tarafından saklanan bellekler doğrulanmıştır ().
POST /memory/verify
Bir belleği doğrulanmış olarak işaretle (Mind Key değil, JWT gerektirir).
[CODE BLOCK]
POST /memory/unverify
Bir belleği doğrulanmamış olarak işaretle (JWT gerektirir).
[CODE BLOCK]
GET /memory/unverified
İnsan doğrulaması bekleyen bellekleri listele.
[CODE BLOCK]
İstatistikler & Denetim
GET /memory/stats
Mevcut mind için toplu istatistikler.
[CODE BLOCK]
Döndürür: 
GET /memory/audit
Tüm durum değiştiren işlemlerin denetim günlüğü.
[CODE BLOCK]
GET /memory/contradictions
Saklanan belleklerde olası çelişkileri tespit et.
[CODE BLOCK]
GET /memory/expiring
Son kullanma tarihi yaklaşan bellekleri listele.
[CODE BLOCK]
Sağlık & Dışa Aktarma
GET /memory/health
Bellek sistemi için hızlı sağlık kontrolü.
[CODE BLOCK]
GET /memory/mind-export
Tüm belleklerin tam JSON dışa aktarımı (yedekleme için).
[CODE BLOCK]
POST /memory/compact
Benzer bellekleri sıkıştır (otomatik özetleme).
[CODE BLOCK]
Sonraki Adımlar
- LLM'ler için Hızlı Başlangıç
- Bellek En İyi Uygulamaları
- FTS5 Arama
- Anlamsal Arama