{"title":"Memory API","slug":"memory","category":"api","summary":"22 bellek uç noktası için tam referans: saklama, geri çağırma, arama, anlamsal arama, senkronizasyon, denetim ve daha fazlası.","audience":["human","llm"],"tags":["api","memory","crud","search","fts5","semantic"],"difficulty":"intermediate","updated":"2026-06-27","word_count":513,"read_minutes":3,"llm_context":"Auth: Mind Key (Authorization: Bearer mk_xxx OR ?key=mk_xxx)\nALWAYS call GET /memory/recall at session start.\nPOST /memory with same category+key updates the existing memory.\nCategories: identity, preference, fact, project, skill, mistake, context, note, credentials\nPriorities: low, normal, high, critical\nSearch: GET /memory/search?q=... (FTS5 syntax: AND, OR, \"phrases\", prefix*)\nSemantic: GET /memory/semantic-search?q=... (slower, conceptual)\nSync: GET /memory/diff?since=TIMESTAMP (incremental sync)\nExport: GET /memory/mind-export (full JSON dump)\n","lang":"tr","translated":true,"requested_lang":"tr","content_markdown":"\n# Memory API\n\nMemory 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.\n\n> [!CRITICAL]\n> **Her oturumun başında `GET /memory/recall` çağrısını daima yapın.** Bu, önceki oturumlardan bağlamı yeniden oluşturmanın tek yoludur.\n\n## Kategoriler\n\nBellekler 8 kategoriye ayrılmıştır:\n\n| Kategori | Kullanım Senaryosu |\n|----------|----------|\n| `identity` | Kullanıcı adı, rol, iletişim bilgisi, kendi hakkındaki tercihler |\n| `preference` | Beğeniler, beğenmemeler, çalışma tarzı, iletişim tercihleri |\n| `fact` | Doğrulanabilir bilgiler (proje detayları, tarihler, URL'ler) |\n| `project` | Proje durumu, kilometre taşları, mimari |\n| `skill` | Kullanıcının iyi olduğu şeyler |\n| `mistake` | Geçmiş hatalar — tekrarlamaktan kaçının |\n| `context` | Oturumla ilgili bağlam |\n| `note` | Çeşitli notlar |\n\n## Öncelikler\n\n- `low` — bilmek güzel\n- `normal` — varsayılan\n- `high` — önemli\n- `critical` — asla unutulmamalı (kullanıcı kimliği, yasal bilgiler)\n\n## Çekirdek Uç Noktalar\n\n### GET /memory/recall\n\nTüm bellekleri LLM için optimize edilmiş düz metin olarak döndürür. Her oturum başlangıcında çağırın.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/memory/recall\n```\n\nYanıt (text/plain):\n\n```\nMind: Michael's Mind\nMemories: 12 total (10 verified)\n\n[001] identity (CRITICAL)\n user_name\n Michael Schäfer\n Tags: person, identity\n\n...\n```\n\n### POST /memory\n\nYeni bir bellek sakla veya mevcut olanı güncelle (aynı kategori + anahtar = güncelleme).\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/memory \\\n -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"category\": \"fact\",\n \"key\": \"user_name\",\n \"content\": \"The user's name is Michael Schäfer\",\n \"tags\": [\"person\", \"identity\"],\n \"priority\": \"critical\"\n }'\n```\n\nYanıt: `{ \"id\": \"mem_001\", \"status\": \"stored\" }`\n\n### GET /memory\n\nİsteğe bağlı filtrelerle bellekleri listele.\n\n```bash\n# All memories (JSON)\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory?limit=50&offset=0\"\n\n# Filter by category\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory?category=project\"\n\n# Filter by tag\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory?tag=docker\"\n```\n\n### PUT /memory/:id\n\nID'ye göre belirli bir belleği güncelle.\n\n```bash\ncurl -X PUT https://synapse.schaefer.zone/memory/mem_001 \\\n -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"content\": \"Updated content\", \"priority\": \"high\"}'\n```\n\n### DELETE /memory/:id\n\nTek bir belleği sil.\n\n```bash\ncurl -X DELETE -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/memory/mem_001\n```\n\n## Arama Uç Noktaları\n\n### GET /memory/search\n\nFTS5 kullanarak tam metin arama.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory/search?q=docker+swarm\"\n```\n\nFTS5 sözdizimi:\n\n- Birden çok kelime = AND: `docker swarm`\n- Deyim: `\"docker swarm\"`\n- Ön ek: `docker*`\n- Boolean: `docker OR kubernetes`\n- Hariç tutma: `docker -swarm`\n\n### GET /memory/semantic-search\n\nGömme (embedding) kullanarak kavramsal arama (FTS5'ten daha yavaştır ama anlamı anlar).\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory/semantic-search?q=container+orchestration\"\n```\n\nHiç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.\n\n### GET /memory/by-tag\n\nEtikete göre bellek listele.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory/by-tag?tag=docker\"\n```\n\n### GET /memory/related/:id\n\nBelirli bir bellekle ilgili bellekleri bul (paylaşılan etiketler aracılığıyla).\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/memory/related/mem_001\n```\n\n## Senkronizasyon & Diff\n\n### GET /memory/diff\n\nArtımlı senkronizasyon — bir zaman damgasından sonraki değişen bellekleri döndürür.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory/diff?since=1700000000\"\n```\n\nYanıt: `{ \"added\": [...], \"updated\": [...], \"deleted\": [...] }`\n\n### POST /memory/sync\n\nBaşka bir örnekten bir diff uygula (self-hosted senkronizasyon için).\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/memory/sync \\\n -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"added\": [...], \"updated\": [...], \"deleted\": [...]}'\n```\n\n## Toplu İşlemler\n\n### POST /memory/bulk-delete\n\nID'ye göre birden çok belleği sil.\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/memory/bulk-delete \\\n -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"ids\": [\"mem_001\", \"mem_002\", \"mem_003\"]}'\n```\n\n### POST /memory/embed-batch\n\nHenüz gömmeye sahip olmayan bellekler için gömme oluştur (anlamsal arama için).\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/memory/embed-batch \\\n -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"limit\": 100}'\n```\n\n### GET /memory/embed-batch-status\n\nGömme oluşturma ilerlemesini kontrol et.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/memory/embed-batch-status\n```\n\n## Doğrulama\n\nBelleklerin bir `verified` bayrağı vardır. Ajan tarafından saklanan bellekler varsayılan olarak doğrulanmamıştır (`source=agent`); insan tarafından saklanan bellekler doğrulanmıştır (`source=user`).\n\n### POST /memory/verify\n\nBir belleği doğrulanmış olarak işaretle (Mind Key değil, JWT gerektirir).\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/memory/mem_001/verify \\\n -H \"Authorization: Bearer YOUR_JWT\"\n```\n\n### POST /memory/unverify\n\nBir belleği doğrulanmamış olarak işaretle (JWT gerektirir).\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/memory/mem_001/unverify \\\n -H \"Authorization: Bearer YOUR_JWT\"\n```\n\n### GET /memory/unverified\n\nİnsan doğrulaması bekleyen bellekleri listele.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory/unverified?limit=100\"\n```\n\n## İstatistikler & Denetim\n\n### GET /memory/stats\n\nMevcut mind için toplu istatistikler.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/memory/stats\n```\n\nDöndürür: `{ \"total\": 12, \"verified\": 10, \"unverified\": 2, \"by_category\": {...}, \"by_priority\": {...} }`\n\n### GET /memory/audit\n\nTüm durum değiştiren işlemlerin denetim günlüğü.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory/audit?limit=100&action=store\"\n```\n\n### GET /memory/contradictions\n\nSaklanan belleklerde olası çelişkileri tespit et.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/memory/contradictions\n```\n\n### GET /memory/expiring\n\nSon kullanma tarihi yaklaşan bellekleri listele.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory/expiring?within=7d\"\n```\n\n## Sağlık & Dışa Aktarma\n\n### GET /memory/health\n\nBellek sistemi için hızlı sağlık kontrolü.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/memory/health\n```\n\n### GET /memory/mind-export\n\nTüm belleklerin tam JSON dışa aktarımı (yedekleme için).\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/memory/mind-export > backup.json\n```\n\n### POST /memory/compact\n\nBenzer bellekleri sıkıştır (otomatik özetleme).\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/memory/compact \\\n -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"dry_run\": true}'\n```\n\n## Sonraki Adımlar\n\n- [LLM'ler için Hızlı Başlangıç](/docs/getting-started/quick-start-llm)\n- [Bellek En İyi Uygulamaları](/docs/guides/memory-best-practices)\n- [FTS5 Arama](/docs/concepts/fts5-search)\n- [Anlamsal Arama](/docs/concepts/semantic-search)\n","content_html":"

Memory API

\n

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.

\n
**Her oturumun başında `GET /memory/recall` çağrısını daima yapın.** Bu, önceki oturumlardan bağlamı yeniden oluşturmanın tek yoludur.

Kategoriler

\n

Bellekler 8 kategoriye ayrılmıştır:

\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\n\n\n\n\n\n\n\n\n\n\n
KategoriKullanım Senaryosu
identityKullanıcı adı, rol, iletişim bilgisi, kendi hakkındaki tercihler
preferenceBeğeniler, beğenmemeler, çalışma tarzı, iletişim tercihleri
factDoğrulanabilir bilgiler (proje detayları, tarihler, URL'ler)
projectProje durumu, kilometre taşları, mimari
skillKullanıcının iyi olduğu şeyler
mistakeGeçmiş hatalar — tekrarlamaktan kaçının
contextOturumla ilgili bağlam
noteÇeşitli notlar
\n

Öncelikler

\n\n

Çekirdek Uç Noktalar

\n

GET /memory/recall

\n

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.

\n
curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     https://synapse.schaefer.zone/memory/recall

Yanıt (text/plain):

\n
Mind: Michael's Mind\nMemories: 12 total (10 verified)\n\n[001] identity (CRITICAL)\n  user_name\n  Michael Schäfer\n  Tags: person, identity\n\n...

POST /memory

\n

Yeni bir bellek sakla veya mevcut olanı güncelle (aynı kategori + anahtar = güncelleme).

\n
curl -X POST https://synapse.schaefer.zone/memory \\\n  -H "Authorization: Bearer YOUR_MIND_KEY" \\\n  -H "Content-Type: application/json" \\\n  -d '{\n    "category": "fact",\n    "key": "user_name",\n    "content": "The user's name is Michael Schäfer",\n    "tags": ["person", "identity"],\n    "priority": "critical"\n  }'

Yanıt: { "id": "mem_001", "status": "stored" }

\n

GET /memory

\n

İsteğe bağlı filtrelerle bellekleri listele.

\n
# All memories (JSON)\ncurl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     "https://synapse.schaefer.zone/memory?limit=50&offset=0"\n\n# Filter by category\ncurl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     "https://synapse.schaefer.zone/memory?category=project"\n\n# Filter by tag\ncurl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     "https://synapse.schaefer.zone/memory?tag=docker"

PUT /memory/:id

\n

ID'ye göre belirli bir belleği güncelle.

\n
curl -X PUT https://synapse.schaefer.zone/memory/mem_001 \\\n  -H "Authorization: Bearer YOUR_MIND_KEY" \\\n  -H "Content-Type: application/json" \\\n  -d '{"content": "Updated content", "priority": "high"}'

DELETE /memory/:id

\n

Tek bir belleği sil.

\n
curl -X DELETE -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     https://synapse.schaefer.zone/memory/mem_001

Arama Uç Noktaları

\n

GET /memory/search

\n

FTS5 kullanarak tam metin arama.

\n
curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     "https://synapse.schaefer.zone/memory/search?q=docker+swarm"

FTS5 sözdizimi:

\n\n

GET /memory/semantic-search

\n

Gömme (embedding) kullanarak kavramsal arama (FTS5'ten daha yavaştır ama anlamı anlar).

\n
curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     "https://synapse.schaefer.zone/memory/semantic-search?q=container+orchestration"

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.

\n

GET /memory/by-tag

\n

Etikete göre bellek listele.

\n
curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     "https://synapse.schaefer.zone/memory/by-tag?tag=docker"

GET /memory/related/:id

\n

Belirli bir bellekle ilgili bellekleri bul (paylaşılan etiketler aracılığıyla).

\n
curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     https://synapse.schaefer.zone/memory/related/mem_001

Senkronizasyon & Diff

\n

GET /memory/diff

\n

Artımlı senkronizasyon — bir zaman damgasından sonraki değişen bellekleri döndürür.

\n
curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     "https://synapse.schaefer.zone/memory/diff?since=1700000000"

Yanıt: { "added": [...], "updated": [...], "deleted": [...] }

\n

POST /memory/sync

\n

Başka bir örnekten bir diff uygula (self-hosted senkronizasyon için).

\n
curl -X POST https://synapse.schaefer.zone/memory/sync \\\n  -H "Authorization: Bearer YOUR_MIND_KEY" \\\n  -H "Content-Type: application/json" \\\n  -d '{"added": [...], "updated": [...], "deleted": [...]}'

Toplu İşlemler

\n

POST /memory/bulk-delete

\n

ID'ye göre birden çok belleği sil.

\n
curl -X POST https://synapse.schaefer.zone/memory/bulk-delete \\\n  -H "Authorization: Bearer YOUR_MIND_KEY" \\\n  -H "Content-Type: application/json" \\\n  -d '{"ids": ["mem_001", "mem_002", "mem_003"]}'

POST /memory/embed-batch

\n

Henüz gömmeye sahip olmayan bellekler için gömme oluştur (anlamsal arama için).

\n
curl -X POST https://synapse.schaefer.zone/memory/embed-batch \\\n  -H "Authorization: Bearer YOUR_MIND_KEY" \\\n  -H "Content-Type: application/json" \\\n  -d '{"limit": 100}'

GET /memory/embed-batch-status

\n

Gömme oluşturma ilerlemesini kontrol et.

\n
curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     https://synapse.schaefer.zone/memory/embed-batch-status

Doğrulama

\n

Belleklerin bir verified bayrağı vardır. Ajan tarafından saklanan bellekler varsayılan olarak doğrulanmamıştır (source=agent); insan tarafından saklanan bellekler doğrulanmıştır (source=user).

\n

POST /memory/verify

\n

Bir belleği doğrulanmış olarak işaretle (Mind Key değil, JWT gerektirir).

\n
curl -X POST https://synapse.schaefer.zone/memory/mem_001/verify \\\n  -H "Authorization: Bearer YOUR_JWT"

POST /memory/unverify

\n

Bir belleği doğrulanmamış olarak işaretle (JWT gerektirir).

\n
curl -X POST https://synapse.schaefer.zone/memory/mem_001/unverify \\\n  -H "Authorization: Bearer YOUR_JWT"

GET /memory/unverified

\n

İnsan doğrulaması bekleyen bellekleri listele.

\n
curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     "https://synapse.schaefer.zone/memory/unverified?limit=100"

İstatistikler & Denetim

\n

GET /memory/stats

\n

Mevcut mind için toplu istatistikler.

\n
curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     https://synapse.schaefer.zone/memory/stats

Döndürür: { "total": 12, "verified": 10, "unverified": 2, "by_category": {...}, "by_priority": {...} }

\n

GET /memory/audit

\n

Tüm durum değiştiren işlemlerin denetim günlüğü.

\n
curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     "https://synapse.schaefer.zone/memory/audit?limit=100&action=store"

GET /memory/contradictions

\n

Saklanan belleklerde olası çelişkileri tespit et.

\n
curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     https://synapse.schaefer.zone/memory/contradictions

GET /memory/expiring

\n

Son kullanma tarihi yaklaşan bellekleri listele.

\n
curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     "https://synapse.schaefer.zone/memory/expiring?within=7d"

Sağlık & Dışa Aktarma

\n

GET /memory/health

\n

Bellek sistemi için hızlı sağlık kontrolü.

\n
curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     https://synapse.schaefer.zone/memory/health

GET /memory/mind-export

\n

Tüm belleklerin tam JSON dışa aktarımı (yedekleme için).

\n
curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     https://synapse.schaefer.zone/memory/mind-export > backup.json

POST /memory/compact

\n

Benzer bellekleri sıkıştır (otomatik özetleme).

\n
curl -X POST https://synapse.schaefer.zone/memory/compact \\\n  -H "Authorization: Bearer YOUR_MIND_KEY" \\\n  -H "Content-Type: application/json" \\\n  -d '{"dry_run": true}'

Sonraki Adımlar

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