Pular para o conteúdo principal

Disable user (Admin only)

DELETE 
/company/users/delete/:id

Desativa um usuário definindo status=false. O usuário permanece na base de dados mas não pode iniciar sessão.

Objetivo​

Permitir que administradores desativem usuários temporariamente sem eliminá-los permanentemente da base de dados.

Casos de Uso​

  • Desativar temporariamente um usuário
  • Suspender acesso enquanto se investiga um incidente
  • Bloquear usuário temporariamente por segurança

Autenticação & Autorização​

  • Requer JWT válido (middleware m.isLoged)
  • Requer função admin ou dev (middleware m.isAdmin)

Comportamento​

  • Procura usuário por ID
  • Define user.status = false
  • Retorna usuário atualizado
  • Não elimina o registo da base de dados

Notas​

  • Este endpoint apenas desativa (status=false)
  • NÃO elimina fisicamente o registo
  • Diferente de DELETE /:id que faz soft delete
  • O usuário pode ser reativado alterando status para true

Comparação​

  • DELETE /:id: Soft delete completo (deleted=true, deletedAt definido)
  • DELETE /delete/:id: Apenas desativa (status=false)
  • PUT /disabled/disable/:id: Soft delete com razão adicional

Request​

Responses​

Usuário desativado com sucesso.