# Memory API
SUMMARY: อ้างอิงครบถ้วนสำหรับ 22 memory endpoint: store, recall, search, semantic search, sync, audit และอื่น ๆ

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 endpoint สำหรับจัดเก็บ, ดึง, ค้นหา, และจัดการ memory ที่มีโครงสร้าง endpoint ทั้งหมดต้องใช้ Mind Key สำหรับการยืนยันตัวตน
> [!CRITICAL]
> เรียก  เสมอที่จุดเริ่มต้นของทุก session นี่เป็นวิธีเดียวที่จะ rebuild context จาก session ก่อนหน้า
Categories
memory ถูกจัดเป็น 8 category:
| Category | กรณีใช้งาน |
|----------|----------|
|  | ชื่อผู้ใช้, role, ข้อมูลติดต่อ, ค่ากำหนดเกี่ยวกับตนเอง |
|  | สิ่งที่ชอบ/ไม่ชอบ, สไตล์การทำงาน, ค่ากำหนดการสื่อสาร |
|  | fact ที่ตรวจสอบได้ (รายละเอียดโปรเจกต์, วันที่, URL) |
|  | สถานะโปรเจกต์, milestone, architecture |
|  | สิ่งที่ผู้ใช้ทำได้ดี |
|  | error ในอดีต — หลีกเลี่ยงการทำซ้ำ |
|  | context ที่เกี่ยวข้องกับ session |
|  | note อื่น ๆ |
Priorities
-  — รู้ไว้ก็ดี
-  — ค่าเริ่มต้น
-  — สำคัญ
-  — ต้องไม่ลืมเด็ดขาด (ตัวตนผู้ใช้, ข้อมูลทางกฎหมาย)
Core Endpoints
GET /memory/recall
ส่งกลับ memory ทั้งหมดในรูปแบบ plain text ที่ปรับให้เหมาะกับ LLM เรียกสิ่งนี้ที่จุดเริ่มต้นของทุก session
[CODE BLOCK]
Response (text/plain):
[CODE BLOCK]
POST /memory
จัดเก็บ memory ใหม่หรืออัปเดต memory ที่มีอยู่ (category + key เดียวกัน = อัปเดต)
[CODE BLOCK]
Response: 
GET /memory
รายการ memory พร้อม filter ที่เลือกได้
[CODE BLOCK]
PUT /memory/:id
อัปเดต memory เฉพาะตาม ID
[CODE BLOCK]
DELETE /memory/:id
ลบ memory เดียว
[CODE BLOCK]
Search Endpoints
GET /memory/search
Full-text search โดยใช้ FTS5
[CODE BLOCK]
ไวยากรณ์ FTS5:
- หลายคำ = AND: 
- Phrase: 
- Prefix: 
- Boolean: 
- Exclude: 
GET /memory/semantic-search
การค้นหาเชิงแนวคิดโดยใช้ embeddings (ช้ากว่า FTS5 แต่เข้าใจความหมาย)
[CODE BLOCK]
ส่งกลับ memory ที่คล้ายเชิง semantic กับ query แม้ไม่มี keyword ตรงกัน มีประโยชน์สำหรับ "ค้นหา memory เกี่ยวกับ X" โดยที่ X ถูกอธิบายต่างกัน
GET /memory/by-tag
รายการ memory ตาม tag
[CODE BLOCK]
GET /memory/related/:id
ค้นหา memory ที่เกี่ยวข้องกับ memory เฉพาะ (ผ่าน tag ที่ใช้ร่วมกัน)
[CODE BLOCK]
Sync & Diff
GET /memory/diff
Sync แบบ incremental — ส่งกลับ memory ที่เปลี่ยนแปลงตั้งแต่ timestamp
[CODE BLOCK]
Response: 
POST /memory/sync
นำ diff จาก instance อื่นมาใช้ (สำหรับ self-hosted sync)
[CODE BLOCK]
การดำเนินการแบบ Bulk
POST /memory/bulk-delete
ลบ memory หลายรายการตาม ID
[CODE BLOCK]
POST /memory/embed-batch
สร้าง embeddings สำหรับ memory ที่ยังไม่มี (สำหรับ semantic search)
[CODE BLOCK]
GET /memory/embed-batch-status
ตรวจสอบความคืบหน้าการสร้าง embedding
[CODE BLOCK]
การยืนยัน
memory มี flag  memory ที่จัดเก็บโดย agent จะเป็น unverified โดยค่าเริ่มต้น (); memory ที่จัดเก็บโดย human จะเป็น verified ()
POST /memory/verify
ทำเครื่องหมาย memory ว่า verified (ต้องใช้ JWT ไม่ใช่ Mind Key)
[CODE BLOCK]
POST /memory/unverify
ทำเครื่องหมาย memory ว่า unverified (ต้องใช้ JWT)
[CODE BLOCK]
GET /memory/unverified
รายการ memory ที่รอการยืนยันจาก human
[CODE BLOCK]
Statistics & Audit
GET /memory/stats
สถิติรวมสำหรับ mind ปัจจุบัน
[CODE BLOCK]
ส่งกลับ: 
GET /memory/audit
Audit log ของการดำเนินการที่เปลี่ยนแปลงสถานะทั้งหมด
[CODE BLOCK]
GET /memory/contradictions
ตรวจหา contradiction ที่อาจเกิดขึ้นใน memory ที่จัดเก็บไว้
[CODE BLOCK]
GET /memory/expiring
รายการ memory ที่มีวันหมดอายุใกล้เข้ามา
[CODE BLOCK]
Health & Export
GET /memory/health
Health check อย่างรวดเร็วสำหรับระบบ memory
[CODE BLOCK]
GET /memory/mind-export
JSON export แบบเต็มของ memory ทั้งหมด (สำหรับสำรองข้อมูล)
[CODE BLOCK]
POST /memory/compact
รวบรวม memory ที่คล้ายกัน (auto-summarization)
[CODE BLOCK]
ขั้นตอนถัดไป
- Quick Start for LLMs
- Memory Best Practices
- FTS5 Search
- Semantic Search