{"title":"API de User y Minds","slug":"user","category":"api","summary":"Gestión de cuenta — registro, login, crear minds, listar minds, eliminar minds. Protegido con JWT.","audience":["human","llm"],"tags":["api","user","account","minds","jwt"],"difficulty":"beginner","updated":"2026-06-27","word_count":331,"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":"es","translated":true,"requested_lang":"es","content_markdown":"\n# API de User y Minds\n\nLa API de User y Minds gestiona la administración de cuentas. Estos endpoints\nusan autenticación JWT (no Mind Keys) porque operan a nivel de cuenta, no a\nnivel de mind.\n\n## Endpoints de autenticación\n\n### POST /register\n\nCrea una nueva cuenta de usuario.\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\nRespuesta:\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\nInicia sesión en una cuenta existente.\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\nRespuesta: igual que `/register`.\n\n## Endpoints de Minds\n\n### POST /minds\n\nCrea un nuevo mind. Devuelve el Mind Key — **guárdelo de inmediato**, solo se\nmuestra una vez.\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\nRespuesta:\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> El `mind_key` se muestra solo una vez. Si lo pierde, no podrá recuperarlo —\n> debe eliminar el mind y crear uno nuevo (lo que pierde todas las memorias\n> almacenadas).\n\n### GET /minds\n\nLista todos los minds del usuario actual.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_JWT\" \\\n https://synapse.schaefer.zone/minds\n```\n\nRespuesta:\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\nElimina un mind de forma permanente.\n\n```bash\ncurl -X DELETE -H \"Authorization: Bearer YOUR_JWT\" \\\n https://synapse.schaefer.zone/minds/m_xyz789\n```\n\n> [!WARNING]\n> Eliminar un mind es **irreversible**. Todas las memorias, tareas, historial\n> de chat y scripts de ese mind se pierden de forma permanente. Exporte primero\n> vía `GET /memory/mind-export` si necesita un backup.\n\n## Patrón multi-mind\n\nLa mayoría de los usuarios se beneficia de tener múltiples minds para mantener\nlos contextos aislados:\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\nUse diferentes Mind Keys en diferentes sesiones LLM para mantener los contextos\naislados.\n\n## Seguridad de la cuenta\n\n### Requisitos de contraseña\n\n- Mínimo 6 caracteres\n- Sin máximo (use un gestor de contraseñas)\n- Se almacena como hash bcrypt (nunca en texto plano)\n\n### Expiración del JWT\n\nLos JWT expiran después de **7 días**. Al expirar, simplemente llame de nuevo a\n`/login`.\n\n### Seguridad del Mind Key\n\nLos Mind Keys nunca expiran. Si un Mind Key se ve comprometido:\n\n1. Cree un nuevo mind vía `POST /minds`\n2. Actualice la configuración de su LLM con el nuevo Mind Key\n3. Elimine el mind comprometido vía `DELETE /minds/:id`\n\n## Próximos pasos\n\n- [Autenticación](/docs/getting-started/authentication) — guía completa de auth\n- [Mind Key vs JWT](/docs/getting-started/mind-key-vs-jwt) — guía de decisión\n- [API de Sharing](/docs/api/user) — compartir minds con otros usuarios\n","content_html":"

API de User y Minds

\n

La API de User y Minds gestiona la administración de cuentas. Estos endpoints\nusan autenticación JWT (no Mind Keys) porque operan a nivel de cuenta, no a\nnivel de mind.

\n

Endpoints de autenticación

\n

POST /register

\n

Crea una nueva cuenta de usuario.

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

Respuesta:

\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

Inicia sesión en una cuenta existente.

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

Respuesta: igual que /register.

\n

Endpoints de Minds

\n

POST /minds

\n

Crea un nuevo mind. Devuelve el Mind Key — guárdelo de inmediato, solo se\nmuestra una vez.

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

Respuesta:

\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}
El `mind_key` se muestra solo una vez. Si lo pierde, no podrá recuperarlo —\ndebe eliminar el mind y crear uno nuevo (lo que pierde todas las memorias\nalmacenadas).

GET /minds

\n

Lista todos los minds del usuario actual.

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

Respuesta:

\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

Elimina un mind de forma permanente.

\n
curl -X DELETE -H "Authorization: Bearer YOUR_JWT" \\\n     https://synapse.schaefer.zone/minds/m_xyz789
Eliminar un mind es **irreversible**. Todas las memorias, tareas, historial\nde chat y scripts de ese mind se pierden de forma permanente. Exporte primero\nvía `GET /memory/mind-export` si necesita un backup.

Patrón multi-mind

\n

La mayoría de los usuarios se beneficia de tener múltiples minds para mantener\nlos contextos aislados:

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

Use diferentes Mind Keys en diferentes sesiones LLM para mantener los contextos\naislados.

\n

Seguridad de la cuenta

\n

Requisitos de contraseña

\n\n

Expiración del JWT

\n

Los JWT expiran después de 7 días. Al expirar, simplemente llame de nuevo a\n/login.

\n

Seguridad del Mind Key

\n

Los Mind Keys nunca expiran. Si un Mind Key se ve comprometido:

\n
    \n
  1. Cree un nuevo mind vía POST /minds
    2. \n
  2. Actualice la configuración de su LLM con el nuevo Mind Key
    3. \n
  3. Elimine el mind comprometido vía DELETE /minds/:id
    4. \n
\n

Próximos pasos

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