Adicionar Informador ao Grupo

Adiciona um informador a um grupo específico

Este endpoint é do tipo: Protected

Descrição

Adiciona um informador específico a um grupo de um processo. O histórico de mudanças é registrado automaticamente.

Adiciona o informador ao grupo especificado de um processo
Regra importante: Um informador só pode estar em UM grupo por processo
Se o informador já estiver em outro grupo do mesmo processo, a operação será bloqueada
Registra automaticamente o histórico de mudanças na tabela informer_group_history
Valida se o informador, grupo e processo existem
Valida se o grupo pertence ao processo informado
Retorna os dados atualizados do informador com grupo e processo
Requer autenticação JWT válida

Detalhes do Endpoint

VERBO

POST

URL BASE

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

ENDPOINT

/groups/{group_id}/informers

Parâmetros de URL

Parâmetro	Tipo	Obrigatório	Descrição
group_id	string (UUID)	Sim	ID do grupo ao qual o informador será adicionado

Body (JSON)

Campo	Tipo	Obrigatório	Descrição
informer_id	string (UUID)	Sim	ID do informador que será adicionado ao grupo
process_id	string (UUID)	Sim	ID do processo ao qual o grupo pertence. Um informador só pode estar em UM grupo por processo.
reason	string	Não	Motivo customizado para o histórico (máx. 500 caracteres). Se não informado, será usado "Adicionado ao grupo/processo"

Cabeçalhos

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

Respostas

Requisição

POST /api/v1/groups/{group_id}/informers
Content-Type: application/json
Authorization: Bearer {token}

{
    "informer_id": "123e4567-e89b-12d3-a456-426614174000",
    "process_id": "987e6543-e21b-34d5-b789-123456789012",
    "reason": "Transferência administrativa"
}

Sucesso - 200

{
  "success": true,
  "data": {
    "id": "uuid-usuario",
    "first_name": "João",
    "last_name": "Silva",
    "email": "joao@example.com",
    "informador_id": "uuid-informador",
    "group": {
      "id": "uuid-grupo",
      "name": "Grupo 1",
      "color": "#000000",
      "description": "Descrição do grupo"
    },
    "process": {
      "id": "uuid-processo",
      "name": "Arquidiocese de Recife",
      "protocol": "PROV-2025-001"
    }
  },
  "message": "Informador adicionado ao grupo 'Grupo 1' no processo 'Arquidiocese de Recife' com sucesso"
}

Nunciatura Provista