Nunciatura Provista

API Documentation V1

Excluir Processo

Remove um processo do sistema

Este endpoint é do tipo: Protected

Descrição

Remove permanentemente um processo do sistema com as seguintes características:

  • Permite exclusão apenas quando não há informadores cadastrados no processo
  • Remove automaticamente respostas de questionários vinculadas ao processo
  • Remove histórico de grupos e vínculos residuais da pivot
  • Operação irreversível - não pode ser desfeita
  • Valida se o processo existe antes da exclusão
  • Retorna confirmação da exclusão
  • Requer autenticação JWT válida

Detalhes do Endpoint

VERBO

DELETE

URL BASE

http://api.provisao.nabrasil.org.br/v1

ENDPOINT

/processes/{id}

Cabeçalhos

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

Parâmetros da URL

Parâmetro Tipo Obrigatório Descrição
id string Sim UUID do processo a ser excluído

Respostas

Sucesso - 200

{
  "success": true,
  "message": "Processo excluído com sucesso"
}

Erro - 404 (Processo não encontrado)

{
  "success": false,
  "message": "Processo não encontrado"
}

Erro - 401 (Token inválido)

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

Erro - 409 (Informadores cadastrados)

{
  "success": false,
  "message": "Não é possível excluir o processo porque existem informadores cadastrados. Remova todos os informadores antes de excluir o processo."
}

Códigos de Resposta

Código Descrição
200 Processo excluído com sucesso
401 Token inválido ou expirado
404 Processo não encontrado
409 Processo possui informadores cadastrados