# Memory API
SUMMARY: 22 मेमोरी एंडपॉइंट्स के लिए संपूर्ण संदर्भ: स्टोर, रिकॉल, खोज, सिमेंटिक खोज, सिंक, ऑडिट, और बहुत कुछ।

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 का हृदय है। यह संरचित मेमोरीज़ को स्टोर करने, पुनः प्राप्त करने, खोजने और प्रबंधित करने के लिए 22 एंडपॉइंट्स प्रदान करता है। सभी एंडपॉइंट्स को प्रमाणीकरण के लिए Mind Key की आवश्यकता है।
> [!CRITICAL]
> हर सत्र की शुरुआत में हमेशा  कॉल करें। यह पिछले सत्रों से संदर्भ को पुनर्निर्माण करने का एकमात्र तरीका है।
श्रेणियाँ
मेमोरीज़ को 8 श्रेणियों में व्यवस्थित किया गया है:
| श्रेणी | उपयोग का मामला |
|----------|----------|
|  | उपयोगकर्ता नाम, भूमिका, संपर्क जानकारी, स्वयं के बारे में प्राथमिकताएँ |
|  | पसंद, नापसंद, कार्य शैली, संचार प्राथमिकताएँ |
|  | सत्यापित योग्य तथ्य (परियोजना विवरण, तिथियाँ, URL) |
|  | परियोजना स्थिति, मील के पत्थर, आर्किटेक्चर |
|  | चीज़ें जिनमें उपयोगकर्ता अच्छा है |
|  | पिछली त्रुटियाँ — दोहराने से बचें |
|  | सत्र-प्रासंगिक संदर्भ |
|  | विविध नोट्स |
प्राथमिकताएँ
-  — जानना अच्छा है
-  — डिफ़ॉल्ट
-  — महत्वपूर्ण
-  — कभी न भूलें (उपयोगकर्ता पहचान, कानूनी जानकारी)
मुख्य एंडपॉइंट्स
GET /memory/recall
सभी मेमोरीज़ को LLM-अनुकूलित सादे टेक्स्ट के रूप में लौटाता है। इसे हर सत्र की शुरुआत में कॉल करें।
[CODE BLOCK]
प्रतिक्रिया (text/plain):
[CODE BLOCK]
POST /memory
नई मेमोरी स्टोर करें या मौजूदा को अपडेट करें (समान श्रेणी + कुंजी = अपडेट)।
[CODE BLOCK]
प्रतिक्रिया: 
GET /memory
वैकल्पिक फ़िल्टर के साथ मेमोरीज़ की सूची बनाएँ।
[CODE BLOCK]
PUT /memory/:id
ID द्वारा एक विशिष्ट मेमोरी अपडेट करें।
[CODE BLOCK]
DELETE /memory/:id
एकल मेमोरी हटाएँ।
[CODE BLOCK]
खोज एंडपॉइंट्स
GET /memory/search
FTS5 का उपयोग करके फुल-टेक्स्ट खोज।
[CODE BLOCK]
FTS5 सिंटैक्स:
- कई शब्द = AND: 
- वाक्यांश: 
- उपसर्ग: 
- बूलियन: 
- बहिष्कार: 
GET /memory/semantic-search
एम्बेडिंग का उपयोग करके वैचारिक खोज (FTS5 से धीमा लेकिन अर्थ समझता है)।
[CODE BLOCK]
वे मेमोरीज़ लौटाता है जो क्वेरी के साथ सिमेंटिक रूप से समान हैं, भले ही कोई कीवर्ड मेल न खाए। "X के बारे में मेमोरीज़ खोजें" के लिए उपयोगी जहाँ X को अलग ढंग से वर्णित किया गया है।
GET /memory/by-tag
टैग द्वारा मेमोरीज़ की सूची बनाएँ।
[CODE BLOCK]
GET /memory/related/:id
किसी विशिष्ट मेमोरी से संबंधित मेमोरीज़ खोजें (साझा टैग के माध्यम से)।
[CODE BLOCK]
सिंक और Diff
GET /memory/diff
इंक्रीमेंटल सिंक — किसी टाइमस्टैम्प के बाद से बदली गई मेमोरीज़ लौटाता है।
[CODE BLOCK]
प्रतिक्रिया: 
POST /memory/sync
किसी अन्य इंस्टेंस से diff लागू करें (सेल्फ-होस्टेड सिंक के लिए)।
[CODE BLOCK]
बल्क ऑपरेशन्स
POST /memory/bulk-delete
ID द्वारा कई मेमोरीज़ हटाएँ।
[CODE BLOCK]
POST /memory/embed-batch
उन मेमोरीज़ के लिए एम्बेडिंग जनरेट करें जिनके पास अभी तक नहीं हैं (सिमेंटिक खोज के लिए)।
[CODE BLOCK]
GET /memory/embed-batch-status
एम्बेडिंग जनरेशन प्रगति जाँचें।
[CODE BLOCK]
सत्यापन
मेमोरीज़ के पास  फ़्लैग होता है। एजेंट-स्टोर की गई मेमोरीज़ डिफ़ॉल्ट रूप से असत्यापित होती हैं (); मानव-स्टोर की गई मेमोरीज़ सत्यापित होती हैं ()।
POST /memory/verify
मेमोरी को सत्यापित के रूप में चिह्नित करें (Mind Key नहीं, JWT आवश्यक)।
[CODE BLOCK]
POST /memory/unverify
मेमोरी को असत्यापित के रूप में चिह्नित करें (JWT आवश्यक)।
[CODE BLOCK]
GET /memory/unverified
मानव सत्यापन की प्रतीक्षा कर रही मेमोरीज़ की सूची बनाएँ।
[CODE BLOCK]
सांख्यिकी और ऑडिट
GET /memory/stats
वर्तमान mind के लिए समग्र सांख्यिकी।
[CODE BLOCK]
लौटाता है: 
GET /memory/audit
सभी स्थिति-परिवर्तनकारी ऑपरेशन्स का ऑडिट लॉग।
[CODE BLOCK]
GET /memory/contradictions
स्टोर की गई मेमोरीज़ में संभावित विरोधाभासों का पता लगाएँ।
[CODE BLOCK]
GET /memory/expiring
समाप्ति तिथि निकट आ रही मेमोरीज़ की सूची बनाएँ।
[CODE BLOCK]
स्वास्थ्य और निर्यात
GET /memory/health
मेमोरी सिस्टम के लिए त्वरित स्वास्थ्य जाँच।
[CODE BLOCK]
GET /memory/mind-export
सभी मेमोरीज़ का पूर्ण JSON निर्यात (बैकअप के लिए)।
[CODE BLOCK]
POST /memory/compact
समान मेमोरीज़ संक्षिप्त करें (ऑटो-सारांशीकरण)।
[CODE BLOCK]
अगले कदम
- LLMs के लिए Quick Start
- मेमोरी सर्वोत्तम प्रथाएँ
- FTS5 Search
- सिमेंटिक खोज