{"title":"User & Minds API","slug":"user","category":"api","summary":"Quản lý tài khoản — đăng ký, đăng nhập, tạo mind, liệt kê mind, xóa mind. Được bảo vệ bằng JWT.","audience":["human","llm"],"tags":["api","user","account","minds","jwt"],"difficulty":"beginner","updated":"2026-06-27","word_count":370,"read_minutes":2,"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":"vi","translated":true,"requested_lang":"vi","content_markdown":"\n# User & Minds API\n\nUser & Minds API xử lý quản lý tài khoản. Các endpoint này sử dụng xác thực JWT\n(không phải Mind Key) vì chúng hoạt động ở cấp tài khoản, không phải cấp mind.\n\n## Endpoint xác thực\n\n### POST /register\n\nTạo tài khoản người dùng mới.\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\nPhản hồi:\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Đăng nhập vào tài khoản hiện có.\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\nPhản hồi: giống như `/register`.\n\n## Endpoint Minds\n\n### POST /minds\n\nTạo một mind mới. Trả về Mind Key — **lưu ngay lập tức**, nó chỉ hiển thị một lần.\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\nPhản hồi:\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` chỉ hiển thị một lần. Nếu bạn mất nó, bạn không thể lấy lại —\n> bạn phải xóa mind và tạo mind mới (điều này mất tất cả bộ nhớ đã lưu).\n\n### GET /minds\n\nLiệt kê tất cả mind của người dùng hiện tại.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_JWT\" \\\n https://synapse.schaefer.zone/minds\n```\n\nPhản hồi:\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\nXóa vĩnh viễn một 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> Xóa mind là **không thể đảo ngược**. Tất cả bộ nhớ, tác vụ, lịch sử chat và\n> script trong mind đó sẽ mất vĩnh viễn. Xuất trước qua `GET /memory/mind-export`\n> nếu bạn cần sao lưu.\n\n## Mẫu Multi-Mind\n\nHầu hết người dùng được lợi từ việc có nhiều mind để giữ các ngữ cảnh tách biệt:\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\nSử dụng các Mind Key khác nhau trong các phiên LLM khác nhau để giữ ngữ cảnh tách biệt.\n\n## Bảo mật tài khoản\n\n### Yêu cầu mật khẩu\n\n- Tối thiểu 6 ký tự\n- Không có giới hạn tối đa (sử dụng trình quản lý mật khẩu)\n- Lưu dưới dạng bcrypt hash (không bao giờ plaintext)\n\n### Hết hạn JWT\n\nJWT hết hạn sau **7 ngày**. Khi hết hạn, chỉ cần gọi lại `/login`.\n\n### Bảo mật Mind Key\n\nMind Key không bao giờ hết hạn. Nếu Mind Key bị xâm phạm:\n\n1. Tạo mind mới qua `POST /minds`\n2. Cập nhật cấu hình LLM với Mind Key mới\n3. Xóa mind bị xâm phạm qua `DELETE /minds/:id`\n\n## Bước tiếp theo\n\n- [Xác thực](/docs/getting-started/authentication) — hướng dẫn xác thực đầy đủ\n- [Mind Key vs JWT](/docs/getting-started/mind-key-vs-jwt) — hướng dẫn quyết định\n- [Sharing API](/docs/api/user) — chia sẻ mind với người dùng khác\n","content_html":"

User & Minds API

\n

User & Minds API xử lý quản lý tài khoản. Các endpoint này sử dụng xác thực JWT\n(không phải Mind Key) vì chúng hoạt động ở cấp tài khoản, không phải cấp mind.

\n

Endpoint xác thực

\n

POST /register

\n

Tạo tài khoản người dùng mới.

\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  }'

Phản hồi:

\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

Đăng nhập vào tài khoản hiện có.

\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  }'

Phản hồi: giống như /register.

\n

Endpoint Minds

\n

POST /minds

\n

Tạo một mind mới. Trả về Mind Key — lưu ngay lập tức, nó chỉ hiển thị một lần.

\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  }'

Phản hồi:

\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` chỉ hiển thị một lần. Nếu bạn mất nó, bạn không thể lấy lại —\nbạn phải xóa mind và tạo mind mới (điều này mất tất cả bộ nhớ đã lưu).

GET /minds

\n

Liệt kê tất cả mind của người dùng hiện tại.

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

Phản hồi:

\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

Xóa vĩnh viễn một mind.

\n
curl -X DELETE -H "Authorization: Bearer YOUR_JWT" \\\n     https://synapse.schaefer.zone/minds/m_xyz789
Xóa mind là **không thể đảo ngược**. Tất cả bộ nhớ, tác vụ, lịch sử chat và\nscript trong mind đó sẽ mất vĩnh viễn. Xuất trước qua `GET /memory/mind-export`\nnếu bạn cần sao lưu.

Mẫu Multi-Mind

\n

Hầu hết người dùng được lợi từ việc có nhiều mind để giữ các ngữ cảnh tách biệt:

\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...

Sử dụng các Mind Key khác nhau trong các phiên LLM khác nhau để giữ ngữ cảnh tách biệt.

\n

Bảo mật tài khoản

\n

Yêu cầu mật khẩu

\n\n

Hết hạn JWT

\n

JWT hết hạn sau 7 ngày. Khi hết hạn, chỉ cần gọi lại /login.

\n

Bảo mật Mind Key

\n

Mind Key không bao giờ hết hạn. Nếu Mind Key bị xâm phạm:

\n
    \n
  1. Tạo mind mới qua POST /minds
    2. \n
  2. Cập nhật cấu hình LLM với Mind Key mới
    3. \n
  3. Xóa mind bị xâm phạm qua DELETE /minds/:id
    4. \n
\n

Bước tiếp theo

\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"]}