Analisar Relatório Manualmente

Registra uma decisão manual (aprovado/negado com justificativa) sobre um relatório existente.

Quando usar

Use este endpoint quando um usuário precisa registrar manualmente a decisão de um relatório, sobrescrevendo ou complementando o resultado automático da política. É a ação que um analista dispara no Toolbox ao aprovar/negar com justificativa (ex.: “aprovado por relacionamento comercial”, “negado por política interna de risco”).

Esta chamada não reprocessa nem recoleta dados das fontes — ela apenas registra a decisão humana. Para refazer uma análise manual já existente, use POST /report/re-analyze.

Autenticação

Bearer JWT no header Authorization.

Parâmetros

Nome	Local	Tipo	Obrigatório	Descrição
id	body	string	sim	ID do relatório que receberá a análise manual.
approved	body	boolean	sim	Decisão do analista: true para aprovar, false para negar.
commentary	body	string	sim	Justificativa/parecer do analista sobre a decisão.

Corpo da requisição

{
  "id": "69a207bcdd0197828df9155a",
  "approved": true,
  "commentary": "Aprovado após análise manual."
}

cURL

curl --location 'https://gyra-core.gyramais.com.br/report/analyze' \
--header 'Authorization: Bearer abc123' \
--header 'Content-Type: application/json' \
--data-raw '{
  "id": "69a207bcdd0197828df9155a",
  "approved": true,
  "commentary": "Aprovado após análise manual."
}'

200 OK

{
  "id": "69a207bcdd0197828df9155a",
  "analystId": "6610684663774970a8cf738d",
  "analystName": "Usuário API",
  "policyStatus": "APPROVED",
  "commentary": "Aprovado após análise manual.",
  "status": {
    "id": "6614758260513064a5af1044",
    "value": "APPROVED",
    "title": "Aprovado"
  },
  "updatedAt": "2026-02-27T21:12:10.110Z"
}