POST/api/users

Criar usuário

Cria uma pessoa (ou um sistema) que entra na clínica com e-mail e senha.

  • Exige o token de acesso — como obter
  • Permissão “Adicionar usuário” (users.create)

Headers

NomeTipoObrig.Descrição
Authorization
stringSimBearer {access_token}, com o token que o login devolve.
Content-Type
stringSimapplication/json

Corpo da requisição

NomeTipoObrig.Descrição
name
stringSimNome.
email
stringSimE-mail de acesso. Único na clínica.
password
stringSimSenha.
role
stringNãoadmin, operator (recepção e pré-laudo) ou medico. Padrão: operator.
permission_group_ids
uuid[]NãoOs grupos de permissão da pessoa.
landing_page
stringNãoA tela inicial: /dashboard, /patients, /consultations, /queue, /pending-reports, /mapa-holter, /analytics ou /settings.

Campos da resposta

NomeTipoDescrição
id
uuidO usuário.
name
stringNome.
email
stringE-mail de acesso, em minúsculas.
role
stringA função: admin, operator (recepção e pré-laudo) ou medico. O que a pessoa pode fazer vem dos grupos.
permission_groups
arrayOs grupos da pessoa ({ id, name }).
permissions
string[]As permissões somadas dos grupos.
is_active
booleanfalse: não entra mais no sistema.
landing_page
string | nullA tela que abre depois do login.
created_at
stringISO 8601.

Request URL

https://api-endosystem.imagemais.com.br/api/users
curl -X POST "https://api-endosystem.imagemais.com.br/api/users" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"Integração Sistema X","email":"integracao@clinica.com.br","password":"uma-senha-longa-e-unica","role":"operator","permission_group_ids":["1f3b5d7a-9c2e-4b4d-a6f8-0b2d4f6a8c0e"]}'
{
  "name": "Integração Sistema X",
  "email": "integracao@clinica.com.br",
  ...
{
  "name": "Integração Sistema X",
  "email": "integracao@clinica.com.br",
  "password": "uma-senha-longa-e-unica",
  "role": "operator",
  "permission_group_ids": [
    "1f3b5d7a-9c2e-4b4d-a6f8-0b2d4f6a8c0e"
  ]
}

Respostas

{
  "id": "6a8c0e2b-4d6f-4a8b-9c1e-3f5a7b9d1c3e",
  "name": "Integração Sistema X",
  ...
{
  "id": "6a8c0e2b-4d6f-4a8b-9c1e-3f5a7b9d1c3e",
  "name": "Integração Sistema X",
  "email": "integracao@clinica.com.br",
  "role": "operator",
  "permission_groups": [
    {
      "id": "1f3b5d7a-9c2e-4b4d-a6f8-0b2d4f6a8c0e",
      "name": "Integração"
    }
  ],
  "permissions": [
    "patients.create",
    "patients.edit"
  ],
  "is_active": true,
  "landing_page": null,
  "created_at": "2026-10-14T08:00:00-03:00"
}
{
  "error": "name, email e password são obrigatórios"
}
{
  "error": "name, email e password são obrigatórios"
}
{
  "error": "role inválido, use admin, operator ou medico"
}
{
  "error": "role inválido, use admin, operator ou medico"
}
{
  "error": "Email já cadastrado nesta conta"
}
{
  "error": "Email já cadastrado nesta conta"
}
{
  "error": "Grupo de permissão não encontrado"
}
{
  "error": "Grupo de permissão não encontrado"
}
{
  "error": "Você não tem a permissão \"Adicionar usuário\".",
  "code": "sem_permissao"
  ...
{
  "error": "Você não tem a permissão \"Adicionar usuário\".",
  "code": "sem_permissao"
}
{
  "error": "Funcionalidade não contratada",
  "message": "Esta funcionalidade não está habilitada para a sua clínica.",
  ...
{
  "error": "Funcionalidade não contratada",
  "message": "Esta funcionalidade não está habilitada para a sua clínica.",
  "code": "FEATURE_NOT_ENABLED"
}
{
  "error": "Token ausente",
  "message": "Token de autenticação necessário.",
  ...
{
  "error": "Token ausente",
  "message": "Token de autenticação necessário.",
  "code": "TOKEN_MISSING"
}
{
  "error": "Token expirado",
  "message": "Sua sessão expirou. Faça login novamente.",
  ...
{
  "error": "Token expirado",
  "message": "Sua sessão expirou. Faça login novamente.",
  "code": "TOKEN_EXPIRED"
}
{
  "error": "Token inválido",
  "message": "Token de autenticação inválido. Faça login novamente.",
  ...
{
  "error": "Token inválido",
  "message": "Token de autenticação inválido. Faça login novamente.",
  "code": "TOKEN_INVALID"
}
{
  "error": "Acesso revogado",
  "message": "Seu acesso foi desativado. Procure o administrador da clínica.",
  ...
{
  "error": "Acesso revogado",
  "message": "Seu acesso foi desativado. Procure o administrador da clínica.",
  "code": "ACCESS_REVOKED"
}
{
  "error": "Erro interno do servidor"
}
{
  "error": "Erro interno do servidor"
}