{"title":"API Utilisateur & Minds","slug":"user","category":"api","summary":"Gestion de compte — inscription, connexion, création de minds, liste de minds, suppression de minds. Protégé par JWT.","audience":["human","llm"],"tags":["api","user","account","minds","jwt"],"difficulty":"beginner","updated":"2026-06-27","word_count":332,"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":"fr","translated":true,"requested_lang":"fr","content_markdown":"\n# API Utilisateur & Minds\n\nL'API Utilisateur & Minds gère l'administration de compte. Ces endpoints utilisent\nl'authentification JWT (pas les Mind Keys) car ils opèrent au niveau du compte, pas au\nniveau du mind.\n\n## Endpoints d'authentification\n\n### POST /register\n\nCrée un nouveau compte utilisateur.\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\nRéponse :\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\nConnexion à un compte existant.\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\nRéponse : identique à `/register`.\n\n## Endpoints Minds\n\n### POST /minds\n\nCrée un nouveau mind. Renvoie la Mind Key — **sauvegardez-la immédiatement**, elle\nn'est affichée qu'une seule fois.\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\nRéponse :\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> La `mind_key` n'est affichée qu'une seule fois. Si vous la perdez, vous ne pouvez\n> pas la récupérer — vous devez supprimer le mind et en créer un nouveau (ce qui\n> perd toutes les mémoires stockées).\n\n### GET /minds\n\nListe tous les minds de l'utilisateur courant.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_JWT\" \\\n https://synapse.schaefer.zone/minds\n```\n\nRéponse :\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\nSupprime un mind définitivement.\n\n```bash\ncurl -X DELETE -H \"Authorization: Bearer YOUR_JWT\" \\\n https://synapse.schaefer.zone/minds/m_xyz789\n```\n\n> [!WARNING]\n> Supprimer un mind est **irréversible**. Toutes les mémoires, tâches, historique de\n> chat et scripts de ce mind sont définitivement perdus. Exportez d'abord via\n> `GET /memory/mind-export` si vous avez besoin d'une sauvegarde.\n\n## Schéma multi-mind\n\nLa plupart des utilisateurs bénéficient de plusieurs minds pour isoler les contextes :\n\n```bash\n# Créer des minds pour différents contextes\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\nUtilisez différentes Mind Keys dans différentes sessions LLM pour garder les contextes\nisolés.\n\n## Sécurité du compte\n\n### Exigences de mot de passe\n\n- Minimum 6 caractères\n- Pas de maximum (utilisez un gestionnaire de mots de passe)\n- Stocké sous forme de hachage bcrypt (jamais en clair)\n\n### Expiration du JWT\n\nLes JWT expirent après **7 jours**. Une fois expirés, appelez simplement `/login` à\nnouveau.\n\n### Sécurité de la Mind Key\n\nLes Mind Keys n'expirent jamais. Si une Mind Key est compromise :\n\n1. Créez un nouveau mind via `POST /minds`\n2. Mettez à jour votre configuration LLM avec la nouvelle Mind Key\n3. Supprimez le mind compromis via `DELETE /minds/:id`\n\n## Prochaines étapes\n\n- [Authentification](/docs/getting-started/authentication) — guide complet d'auth\n- [Mind Key vs JWT](/docs/getting-started/mind-key-vs-jwt) — guide de décision\n- [API Sharing](/docs/api/user) — partager des minds avec d'autres utilisateurs\n","content_html":"

API Utilisateur & Minds

\n

L'API Utilisateur & Minds gère l'administration de compte. Ces endpoints utilisent\nl'authentification JWT (pas les Mind Keys) car ils opèrent au niveau du compte, pas au\nniveau du mind.

\n

Endpoints d'authentification

\n

POST /register

\n

Crée un nouveau compte utilisateur.

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

Réponse :

\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

Connexion à un compte existant.

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

Réponse : identique à /register.

\n

Endpoints Minds

\n

POST /minds

\n

Crée un nouveau mind. Renvoie la Mind Key — sauvegardez-la immédiatement, elle\nn'est affichée qu'une seule fois.

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

Réponse :

\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}
La `mind_key` n'est affichée qu'une seule fois. Si vous la perdez, vous ne pouvez\npas la récupérer — vous devez supprimer le mind et en créer un nouveau (ce qui\nperd toutes les mémoires stockées).

GET /minds

\n

Liste tous les minds de l'utilisateur courant.

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

Réponse :

\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

Supprime un mind définitivement.

\n
curl -X DELETE -H "Authorization: Bearer YOUR_JWT" \\\n     https://synapse.schaefer.zone/minds/m_xyz789
Supprimer un mind est **irréversible**. Toutes les mémoires, tâches, historique de\nchat et scripts de ce mind sont définitivement perdus. Exportez d'abord via\n`GET /memory/mind-export` si vous avez besoin d'une sauvegarde.

Schéma multi-mind

\n

La plupart des utilisateurs bénéficient de plusieurs minds pour isoler les contextes :

\n
# Créer des minds pour différents contextes\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...

Utilisez différentes Mind Keys dans différentes sessions LLM pour garder les contextes\nisolés.

\n

Sécurité du compte

\n

Exigences de mot de passe

\n\n

Expiration du JWT

\n

Les JWT expirent après 7 jours. Une fois expirés, appelez simplement /login à\nnouveau.

\n

Sécurité de la Mind Key

\n

Les Mind Keys n'expirent jamais. Si une Mind Key est compromise :

\n
    \n
  1. Créez un nouveau mind via POST /minds
    2. \n
  2. Mettez à jour votre configuration LLM avec la nouvelle Mind Key
    3. \n
  3. Supprimez le mind compromis via DELETE /minds/:id
    4. \n
\n

Prochaines étapes

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