{"title":"User & Minds API","slug":"user","category":"api","summary":"การจัดการบัญชี — สมัคร, ล็อกอิน, สร้าง mind, รายการ mind, ลบ mind ป้องกันด้วย JWT","audience":["human","llm"],"tags":["api","user","account","minds","jwt"],"difficulty":"beginner","updated":"2026-06-27","word_count":191,"read_minutes":1,"llm_context":"Auth: JWT (from /register or /login)\nRegister: POST /register { email, password, display_name? } → returns JWT\nLogin: POST /login { email, password } → returns JWT\nCreate mind: POST /minds { name, description? } → returns mind_key (shown once!)\nList minds: GET /minds\nDelete mind: DELETE /minds/:id (irreversible — deletes all memories!)\nJWT expires after 7 days. Mind Key never expires.\nMind Key is shown only once at creation — save it permanently.\n","lang":"th","translated":true,"requested_lang":"th","content_markdown":"\n# User & Minds API\n\nUser & Minds API จัดการบัญชี endpoint เหล่านี้ใช้ JWT authentication (ไม่ใช่ Mind Key) เพราะทำงานในระดับบัญชี ไม่ใช่ระดับ mind\n\n## Endpoint ยืนยันตัวตน\n\n### POST /register\n\nสร้างบัญชีผู้ใช้ใหม่\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/register \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"email\": \"you@example.com\",\n \"password\": \"your-secure-password\",\n \"display_name\": \"Michael\"\n }'\n```\n\nResponse:\n\n```json\n{\n \"jwt\": \"eyJhbGci...\",\n \"user\": {\n \"id\": \"u_abc123\",\n \"email\": \"you@example.com\",\n \"display_name\": \"Michael\",\n \"created_at\": \"2026-06-27T...\"\n }\n}\n```\n\n### POST /login\n\nล็อกอินเข้าสู่บัญชีที่มีอยู่\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/login \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"email\": \"you@example.com\",\n \"password\": \"your-secure-password\"\n }'\n```\n\nResponse: เหมือนกับ `/register`\n\n## Minds Endpoints\n\n### POST /minds\n\nสร้าง mind ใหม่ ส่งกลับ Mind Key — **บันทึกทันที** แสดงเพียงครั้งเดียว\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/minds \\\n -H \"Authorization: Bearer YOUR_JWT\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"name\": \"Work Mind\",\n \"description\": \"Job-related memories\"\n }'\n```\n\nResponse:\n\n```json\n{\n \"id\": \"m_xyz789\",\n \"name\": \"Work Mind\",\n \"description\": \"Job-related memories\",\n \"mind_key\": \"mk_aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789\",\n \"created_at\": \"2026-06-27T...\"\n}\n```\n\n> [!CRITICAL]\n> `mind_key` แสดงเพียงครั้งเดียว หากคุณสูญเสียจะดึงคืนไม่ได้ — ต้องลบ mind และสร้างใหม่ (ซึ่งจะสูญเสีย memory ที่จัดเก็บไว้ทั้งหมด)\n\n### GET /minds\n\nรายการ mind ทั้งหมดของผู้ใช้ปัจจุบัน\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_JWT\" \\\n https://synapse.schaefer.zone/minds\n```\n\nResponse:\n\n```json\n{\n \"minds\": [\n {\n \"id\": \"m_xyz789\",\n \"name\": \"Work Mind\",\n \"description\": \"Job-related memories\",\n \"created_at\": \"2026-06-27T...\",\n \"memory_count\": 142,\n \"last_activity\": \"2026-06-27T...\"\n }\n ]\n}\n```\n\n### DELETE /minds/:id\n\nลบ mind อย่างถาวร\n\n```bash\ncurl -X DELETE -H \"Authorization: Bearer YOUR_JWT\" \\\n https://synapse.schaefer.zone/minds/m_xyz789\n```\n\n> [!WARNING]\n> การลบ mind **เป็นการกระทำที่ย้อนกลับไม่ได้** memory, task, chat history และ script ทั้งหมดใน mind นั้นจะสูญหายอย่างถาวร export ก่อนผ่าน `GET /memory/mind-export` หากคุณต้องการสำรองข้อมูล\n\n## รูปแบบ Multi-Mind\n\nผู้ใช้ส่วนใหญ่ได้ประโยชน์จากหลาย mind เพื่อแยก context:\n\n```bash\n# Create minds for different contexts\ncurl -X POST .../minds -d '{\"name\": \"work\", \"description\": \"Job\"}'\n# → mind_key: mk_work...\n\ncurl -X POST .../minds -d '{\"name\": \"personal\", \"description\": \"Personal life\"}'\n# → mind_key: mk_personal...\n\ncurl -X POST .../minds -d '{\"name\": \"project-synapse\", \"description\": \"Synapse dev\"}'\n# → mind_key: mk_synapse...\n```\n\nใช้ Mind Key ต่างกันใน LLM session ต่างกันเพื่อแยก context\n\n## ความปลอดภัยบัญชี\n\n### ข้อกำหนดรหัสผ่าน\n\n- ขั้นต่ำ 6 ตัวอักษร\n- ไม่จำกัดความยาวสูงสุด (ใช้ password manager)\n- เก็บเป็น bcrypt hash (ไม่เก็บ plaintext เด็ดขาด)\n\n### การหมดอายุของ JWT\n\nJWT หมดอายุหลัง **7 วัน** เมื่อหมดอายุเรียก `/login` อีกครั้ง\n\n### ความปลอดภัยของ Mind Key\n\nMind Key ไม่มีวันหมดอายุ หาก Mind Key ถูกโจมตี:\n\n1. สร้าง mind ใหม่ผ่าน `POST /minds`\n2. อัปเดต config ของ LLM ด้วย Mind Key ใหม่\n3. ลบ mind ที่ถูกโจมตีผ่าน `DELETE /minds/:id`\n\n## ขั้นตอนถัดไป\n\n- [Authentication](/docs/getting-started/authentication) — คู่มือ auth แบบเต็ม\n- [Mind Key vs JWT](/docs/getting-started/mind-key-vs-jwt) — คู่มือการตัดสินใจ\n- [Sharing API](/docs/api/user) — แชร์ mind กับผู้ใช้อื่น\n","content_html":"

User & Minds API

\n

User & Minds API จัดการบัญชี endpoint เหล่านี้ใช้ JWT authentication (ไม่ใช่ Mind Key) เพราะทำงานในระดับบัญชี ไม่ใช่ระดับ mind

\n

Endpoint ยืนยันตัวตน

\n

POST /register

\n

สร้างบัญชีผู้ใช้ใหม่

\n
curl -X POST https://synapse.schaefer.zone/register \\\n  -H "Content-Type: application/json" \\\n  -d '{\n    "email": "you@example.com",\n    "password": "your-secure-password",\n    "display_name": "Michael"\n  }'

Response:

\n
{\n  "jwt": "eyJhbGci...",\n  "user": {\n    "id": "u_abc123",\n    "email": "you@example.com",\n    "display_name": "Michael",\n    "created_at": "2026-06-27T..."\n  }\n}

POST /login

\n

ล็อกอินเข้าสู่บัญชีที่มีอยู่

\n
curl -X POST https://synapse.schaefer.zone/login \\\n  -H "Content-Type: application/json" \\\n  -d '{\n    "email": "you@example.com",\n    "password": "your-secure-password"\n  }'

Response: เหมือนกับ /register

\n

Minds Endpoints

\n

POST /minds

\n

สร้าง mind ใหม่ ส่งกลับ Mind Key — บันทึกทันที แสดงเพียงครั้งเดียว

\n
curl -X POST https://synapse.schaefer.zone/minds \\\n  -H "Authorization: Bearer YOUR_JWT" \\\n  -H "Content-Type: application/json" \\\n  -d '{\n    "name": "Work Mind",\n    "description": "Job-related memories"\n  }'

Response:

\n
{\n  "id": "m_xyz789",\n  "name": "Work Mind",\n  "description": "Job-related memories",\n  "mind_key": "mk_aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789",\n  "created_at": "2026-06-27T..."\n}
`mind_key` แสดงเพียงครั้งเดียว หากคุณสูญเสียจะดึงคืนไม่ได้ — ต้องลบ mind และสร้างใหม่ (ซึ่งจะสูญเสีย memory ที่จัดเก็บไว้ทั้งหมด)

GET /minds

\n

รายการ mind ทั้งหมดของผู้ใช้ปัจจุบัน

\n
curl -H "Authorization: Bearer YOUR_JWT" \\\n     https://synapse.schaefer.zone/minds

Response:

\n
{\n  "minds": [\n    {\n      "id": "m_xyz789",\n      "name": "Work Mind",\n      "description": "Job-related memories",\n      "created_at": "2026-06-27T...",\n      "memory_count": 142,\n      "last_activity": "2026-06-27T..."\n    }\n  ]\n}

DELETE /minds/:id

\n

ลบ mind อย่างถาวร

\n
curl -X DELETE -H "Authorization: Bearer YOUR_JWT" \\\n     https://synapse.schaefer.zone/minds/m_xyz789
การลบ mind **เป็นการกระทำที่ย้อนกลับไม่ได้** memory, task, chat history และ script ทั้งหมดใน mind นั้นจะสูญหายอย่างถาวร export ก่อนผ่าน `GET /memory/mind-export` หากคุณต้องการสำรองข้อมูล

รูปแบบ Multi-Mind

\n

ผู้ใช้ส่วนใหญ่ได้ประโยชน์จากหลาย mind เพื่อแยก context:

\n
# Create minds for different contexts\ncurl -X POST .../minds -d '{"name": "work", "description": "Job"}'\n# → mind_key: mk_work...\n\ncurl -X POST .../minds -d '{"name": "personal", "description": "Personal life"}'\n# → mind_key: mk_personal...\n\ncurl -X POST .../minds -d '{"name": "project-synapse", "description": "Synapse dev"}'\n# → mind_key: mk_synapse...

ใช้ Mind Key ต่างกันใน LLM session ต่างกันเพื่อแยก context

\n

ความปลอดภัยบัญชี

\n

ข้อกำหนดรหัสผ่าน

\n\n

การหมดอายุของ JWT

\n

JWT หมดอายุหลัง 7 วัน เมื่อหมดอายุเรียก /login อีกครั้ง

\n

ความปลอดภัยของ Mind Key

\n

Mind Key ไม่มีวันหมดอายุ หาก Mind Key ถูกโจมตี:

\n
    \n
  1. สร้าง mind ใหม่ผ่าน POST /minds
    2. \n
  2. อัปเดต config ของ LLM ด้วย Mind Key ใหม่
    3. \n
  3. ลบ mind ที่ถูกโจมตีผ่าน DELETE /minds/:id
    4. \n
\n

ขั้นตอนถัดไป

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