Refazer Análise Manual

Refaz uma análise manual já registrada em um relatório, substituindo o parecer anterior.

Quando usar

Use este endpoint para refazer a análise manual de um relatório que já recebeu uma decisão humana prévia via POST /report/analyze. Cenário típico: nova informação chegou, o analista quer mudar o parecer registrado (ex.: de aprovado para negado), e ele tem permissão para revisar análises manuais.

Esta chamada só funciona quando já existe uma análise manual registrada no relatório. Se nenhuma decisão manual foi feita ainda, use POST /report/analyze. O endpoint também não reprocessa dados das fontes — apenas atualiza a decisão humana.

Autenticação

Bearer JWT no header Authorization. O usuário precisa ter permissão para refazer análises manuais.

Parâmetros

Nome	Local	Tipo	Obrigatório	Descrição
id	body	string	sim	ID do relatório cuja análise manual será refeita.
approved	body	boolean	sim	Nova decisão: true para aprovar, false para negar.
commentary	body	string	sim	Nova justificativa/parecer substituindo o anterior.

Corpo da requisição

{
  "id": "69a207bcdd0197828df9155a",
  "approved": false,
  "commentary": "Revisão: informação adicional identificou risco não mapeado. Decisão alterada para negado."
}

cURL

curl --location 'https://gyra-core.gyramais.com.br/report/re-analyze' \
--header 'Authorization: Bearer abc123' \
--header 'Content-Type: application/json' \
--data-raw '{
  "id": "69a207bcdd0197828df9155a",
  "approved": false,
  "commentary": "Revisão: decisão alterada para negado."
}'

200 OK

{
  "id": "69a207bcdd0197828df9155a",
  "analystId": "6610684663774970a8cf738d",
  "analystName": "Usuário API",
  "policyStatus": "DENIED",
  "commentary": "Revisão: decisão alterada para negado.",
  "status": {
    "id": "6614758260513064a5af1045",
    "value": "DENIED",
    "title": "Negado"
  },
  "updatedAt": "2026-02-27T22:02:10.110Z"
}