{"title":"API de Usuário e Minds","slug":"user","category":"api","summary":"Gerenciamento de conta — registrar, login, criar minds, listar minds, excluir minds. Protegido por JWT.","audience":["human","llm"],"tags":["api","user","account","minds","jwt"],"difficulty":"beginner","updated":"2026-06-27","word_count":316,"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":"pt","translated":true,"requested_lang":"pt","content_markdown":"\n# API de Usuário e Minds\n\nA API de Usuário e Minds cuida do gerenciamento de conta. Esses endpoints usam\nautenticação JWT (não Mind Keys) porque operam em nível de conta, não em nível\nde mind.\n\n## Endpoints de autenticação\n\n### POST /register\n\nCria uma nova conta de usuário.\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\nResposta:\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\nFaz login em uma conta 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\nResposta: mesma de `/register`.\n\n## Endpoints de minds\n\n### POST /minds\n\nCria um novo mind. Retorna a Mind Key — **salve-a imediatamente**, ela é\nexibida apenas uma 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\nResposta:\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> A `mind_key` é exibida apenas uma vez. Se você a perder, não poderá recuperá-\n> -la — será necessário excluir o mind e criar um novo (o que apaga todas as\n> memórias armazenadas).\n\n### GET /minds\n\nLista todos os minds do usuário atual.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_JWT\" \\\n https://synapse.schaefer.zone/minds\n```\n\nResposta:\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\nExclui um mind permanentemente.\n\n```bash\ncurl -X DELETE -H \"Authorization: Bearer YOUR_JWT\" \\\n https://synapse.schaefer.zone/minds/m_xyz789\n```\n\n> [!WARNING]\n> Excluir um mind é **irreversível**. Todas as memórias, tarefas, histórico de\n> chat e scripts desse mind são perdidos permanentemente. Exporte antes via\n> `GET /memory/mind-export` se precisar de backup.\n\n## Padrão multi-mind\n\nA maioria dos usuários se beneficia de múltiplos minds para manter contextos\nisolados:\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 Mind Keys diferentes em sessões LLM diferentes para manter contextos\nisolados.\n\n## Segurança da conta\n\n### Requisitos de senha\n\n- Mínimo de 6 caracteres\n- Sem máximo (use um gerenciador de senhas)\n- Armazenada como hash bcrypt (nunca em texto puro)\n\n### Expiração do JWT\n\nJWTs expiram após **7 dias**. Quando expirar, basta chamar `/login` novamente.\n\n### Segurança da Mind Key\n\nMind Keys nunca expiram. Se uma Mind Key for comprometida:\n\n1. Crie um novo mind via `POST /minds`\n2. Atualize sua configuração de LLM com a nova Mind Key\n3. Exclua o mind comprometido via `DELETE /minds/:id`\n\n## Próximos passos\n\n- [Autenticação](/docs/getting-started/authentication) — guia completo de auth\n- [Mind Key vs JWT](/docs/getting-started/mind-key-vs-jwt) — guia de decisão\n- [API de Compartilhamento](/docs/api/user) — compartilhe minds com outros usuários\n","content_html":"

API de Usuário e Minds

\n

A API de Usuário e Minds cuida do gerenciamento de conta. Esses endpoints usam\nautenticação JWT (não Mind Keys) porque operam em nível de conta, não em nível\nde mind.

\n

Endpoints de autenticação

\n

POST /register

\n

Cria uma nova conta de usuário.

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

Resposta:

\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

Faz login em uma conta 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  }'

Resposta: mesma de /register.

\n

Endpoints de minds

\n

POST /minds

\n

Cria um novo mind. Retorna a Mind Key — salve-a imediatamente, ela é\nexibida apenas uma 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  }'

Resposta:

\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}
A `mind_key` é exibida apenas uma vez. Se você a perder, não poderá recuperá-\n-la — será necessário excluir o mind e criar um novo (o que apaga todas as\nmemórias armazenadas).

GET /minds

\n

Lista todos os minds do usuário atual.

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

Resposta:

\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

Exclui um mind permanentemente.

\n
curl -X DELETE -H "Authorization: Bearer YOUR_JWT" \\\n     https://synapse.schaefer.zone/minds/m_xyz789
Excluir um mind é **irreversível**. Todas as memórias, tarefas, histórico de\nchat e scripts desse mind são perdidos permanentemente. Exporte antes via\n`GET /memory/mind-export` se precisar de backup.

Padrão multi-mind

\n

A maioria dos usuários se beneficia de múltiplos minds para manter contextos\nisolados:

\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 Mind Keys diferentes em sessões LLM diferentes para manter contextos\nisolados.

\n

Segurança da conta

\n

Requisitos de senha

\n\n

Expiração do JWT

\n

JWTs expiram após 7 dias. Quando expirar, basta chamar /login novamente.

\n

Segurança da Mind Key

\n

Mind Keys nunca expiram. Se uma Mind Key for comprometida:

\n
    \n
  1. Crie um novo mind via POST /minds
    2. \n
  2. Atualize sua configuração de LLM com a nova Mind Key
    3. \n
  3. Exclua o mind comprometido via DELETE /minds/:id
    4. \n
\n

Próximos passos

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