Nunciatura Provista

API Documentation V1

Remover Usuário

Remove um usuário do sistema permanentemente

Este endpoint é do tipo: Protected

Descrição

Remove um usuário do sistema permanentemente com as seguintes funcionalidades:

  • Remove o usuário do banco de dados permanentemente
  • Se o usuário for Informador, remove também os dados do informer
  • Remove automaticamente registros relacionados (candidates, questionnaire_answers) via cascade
  • Operação realizada em transação para garantir consistência
  • Retorna confirmação da exclusão
  • Requer autenticação JWT válida
  • Inclui logs detalhados para auditoria e debug

Detalhes do Endpoint

VERBO

DELETE

URL BASE

http://api.provista.dev.nabrasil.org.br/v1

ENDPOINT

/users/{id}

Parâmetros da URL

Campo Tipo Obrigatório Descrição
id string (UUID) Sim ID único do usuário

Cabeçalhos

Parâmetro Valor
Authorization Bearer <token>
Accept application/json
Content-Type application/json

Respostas

Sucesso - 200

{
  "success": true,
  "message": "Usuário excluído com sucesso"
}

Erro - 404 (Usuário não encontrado)

{
  "success": false,
  "message": "Usuário não encontrado"
}

Condição: Usuário com o ID especificado não existe

Erro - 401 (Token inválido)

{
  "success": false,
  "message": "Token não fornecido"
}

Condição: Token JWT inválido, expirado ou não fornecido

Códigos de Resposta

Código Descrição
200 Usuário excluído com sucesso
404 Usuário não encontrado
401 Token inválido ou expirado