Convocar Comitê de Crédito IA

curl --location --request POST 'https://gyra-core.gyramais.com.br/report/6612a7f30000000000000001/committee' \
--header 'Authorization: Bearer {seu_token_jwt}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "force": false
}'

fetch("https://gyra-core.gyramais.com.br/report/6612a7f30000000000000001/committee", {
  method: "POST",
  headers: {
    "Authorization": "Bearer {seu_token_jwt}",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ force: false })
})
  .then(res => res.json())
  .then(console.log)

import requests

url = "https://gyra-core.gyramais.com.br/report/6612a7f30000000000000001/committee"
headers = {"Authorization": "Bearer {seu_token_jwt}"}
payload = {"force": False}

response = requests.post(url, headers=headers, json=payload)
print(response.json())

{
  "status": "RUNNING",
  "trigger": "MANUAL"
}

{
  "status": "RUNNING",
  "trigger": "RERUN"
}

{
  "code": 400,
  "message": "Os pareceres por seção ainda não finalizaram. Aguarde a conclusão para convocar o comitê."
}

{
  "code": 404,
  "message": "Relatório não encontrado"
}

{
  "code": 409,
  "message": "O comitê já está em deliberação para este relatório."
}

Quando usar

É o mesmo endpoint que o botão Convocar Comitê do toolbox usa. Ele existe para as duas primeiras das três configurações de comitê da política:

Configuração da política	Como este endpoint entra
Não convocar automaticamente	É a única forma de levar o relatório a comitê. Use para triagem sob demanda, exceção de alçada, ou fluxos em que só parte da carteira vai a comitê.
Convocar comitê e sugerir decisão	O comitê já rodou sozinho. Use para reconvocar, por exemplo depois de subir um balanço ou corrigir dados do relatório. A decisão final continua com o analista, via `POST /report/analyze`.
Convocar comitê e decisão automática	Normalmente você não precisa: o comitê já rodou e já aplicou a decisão no status do relatório. Uma reconvocação aqui gera uma nova deliberação como sugestão, e não altera o status já registrado.

Também funciona para reconvocar um relatório cujo comitê falhou (ERROR) ou foi pulado (SKIPPED).

Convocação manual sempre entra como sugestão, nunca decide sozinha. Só o gatilho automático da política Convocar comitê e decisão automática aplica a decisão no status do relatório.

Conceito completo em Comitê de Crédito IA.

Autenticação

Bearer JWT no header Authorization. A organização do token é a única que enxerga o relatório: um id de outra organização retorna 404.

Parâmetros

Nome	Local	Tipo	Obrigatório	Descrição
`id`	`path`	`string`	`sim`	ID do relatório que vai a comitê.
`force`	`body`	`boolean`	`não`	Padrão `false`. Ignora o cache da deliberação e força os agentes a reprocessarem do zero. Use ao reconvocar depois de corrigir dados do relatório.

Pré-requisitos

A convocação é recusada com 400 se o relatório ainda não está pronto para o comitê:

A política precisa habilitar o pipeline de parecer

Sem parecer por seção não existe insumo para o comitê.

Os pareceres por seção precisam ter terminado

Não há evento que anuncie isso. Veja o padrão de integração abaixo.

A política de crédito precisa ter concluído

Se o relatório tem policyId, o resultado da política precisa ter chegado.

O webhook REPORT_FINISHED não é garantia de que o comitê pode ser convocado. Ele sinaliza que as integrações do relatório terminaram, que é um pipeline diferente do de pareceres. Os pareceres por seção rodam depois e podem continuar processando por mais alguns instantes. Convocar o comitê no exato momento em que o REPORT_FINISHED chega costuma devolver 400.

Se todo relatório dessa política deve ir a comitê, não use este endpoint. Configure a política como Convocar comitê e sugerir decisão e a plataforma convoca sozinha, na hora certa, sem você precisar acertar o momento nem tratar retry. A deliberação chega pelo webhook COMMITTEE_FINISHED com trigger: "AUTO_SUGGEST", e a decisão final continua sendo do analista, igual à convocação manual.Este endpoint existe para o caso oposto: quando o comitê é exceção, disparada por uma pessoa no seu sistema (um botão na tela do analista, uma aprovação de alçada) ou por uma regra sua que seleciona quais casos valem a deliberação. É aí que o padrão abaixo importa.

Padrão de integração recomendado

Não existe hoje um evento que anuncie “os pareceres terminaram”. O caminho robusto é tratar o 400 de prontidão como estado transitório e repetir:

Aguarde o REPORT_FINISHED

Ele indica que a análise entrou na reta final. Serve como ponto de partida, não como sinal de prontidão.

Chame o endpoint e leia o erro

Um 200 significa que a deliberação começou. Um 400 de pareceres ainda não finalizaram ou de política ainda não concluiu significa “ainda não, tente de novo”.

Repita com backoff

Aguarde alguns segundos e chame novamente. Na prática os pareceres fecham em menos de um minuto depois do relatório. Estabeleça um teto de tentativas para não repetir indefinidamente.

Pare nos erros terminais

Comitê não habilitado na política e nenhum parecer disponível não mudam com o tempo. Nesses casos, não repita.

Consulte a tabela de erros abaixo: a coluna Repetir diz quais valem nova tentativa.

GET /report/{id}/insights mostra os pareceres já concluídos, mas não informa quantos faltam. Serve para acompanhar o progresso, não para decidir que tudo terminou. Quem tem essa informação é o próprio endpoint de convocação, na resposta que ele devolve.

Resposta

A chamada é assíncrona. O 200 confirma que a deliberação foi aceita e iniciada, não que ela terminou.

Campo	Descrição
`status`	Sempre `RUNNING` no sucesso.
`trigger`	`MANUAL` na primeira deliberação do relatório, `RERUN` quando já havia uma anterior.

Para saber o resultado, registre o webhook COMMITTEE_FINISHED ou consulte GET /report/{id}/insights.

curl --location --request POST 'https://gyra-core.gyramais.com.br/report/6612a7f30000000000000001/committee' \
--header 'Authorization: Bearer {seu_token_jwt}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "force": false
}'

fetch("https://gyra-core.gyramais.com.br/report/6612a7f30000000000000001/committee", {
  method: "POST",
  headers: {
    "Authorization": "Bearer {seu_token_jwt}",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ force: false })
})
  .then(res => res.json())
  .then(console.log)

import requests

url = "https://gyra-core.gyramais.com.br/report/6612a7f30000000000000001/committee"
headers = {"Authorization": "Bearer {seu_token_jwt}"}
payload = {"force": False}

response = requests.post(url, headers=headers, json=payload)
print(response.json())

{
  "status": "RUNNING",
  "trigger": "MANUAL"
}

{
  "status": "RUNNING",
  "trigger": "RERUN"
}

{
  "code": 400,
  "message": "Os pareceres por seção ainda não finalizaram. Aguarde a conclusão para convocar o comitê."
}

{
  "code": 404,
  "message": "Relatório não encontrado"
}

{
  "code": 409,
  "message": "O comitê já está em deliberação para este relatório."
}

Erros

Código	Mensagem	Causa	Repetir
`400`	`"Os pareceres por seção ainda não finalizaram. Aguarde a conclusão para convocar o comitê."`	O relatório ainda está gerando pareceres.	Sim, com backoff
`400`	`"A política de crédito ainda não concluiu. Aguarde o resultado da política para convocar o comitê."`	O resultado da política ainda não chegou.	Sim, com backoff
`400`	`"O comitê de crédito não está habilitado para a política deste relatório."`	A política do relatório não habilita o pipeline de parecer.	Não, é definitivo
`400`	`"Nenhum parecer por seção disponível para deliberação do comitê."`	Nenhuma seção produziu parecer; não há insumo.	Não, é definitivo
`404`	`"Relatório não encontrado"`	ID inexistente ou de outra organização.	Não
`409`	`"O comitê já está em deliberação para este relatório."`	Já existe uma deliberação `RUNNING`.	Não. A deliberação já começou, aguarde o `COMMITTEE_FINISHED`

Trate o 409 como sucesso na sua lógica de retry: ele significa que a deliberação está em andamento, seja porque outra chamada sua já passou, seja porque a política convocou automaticamente.

Próximos passos

Comitê de Crédito IA

Agentes, modos e regras de convocação.

Consultar Pareceres

Pareceres por seção e resumo da decisão.

Consultar Deliberação

Votos individuais, custo e auditoria.

Criar Webhook

Receber COMMITTEE_FINISHED.

Primeiros Passos

Conceitos Fundamentais

Guia do Toolbox

Fontes de Dados

Guias

Casos de Uso

MCP Server

Referência da API

Dicionário de Dados

Integrações

Referência

Convocar Comitê de Crédito IA

Quando usar

Autenticação

Parâmetros

Pré-requisitos

Padrão de integração recomendado

Resposta

Erros

Próximos passos

Comitê de Crédito IA

Consultar Pareceres

Consultar Deliberação

Criar Webhook

​Quando usar

​Autenticação

​Parâmetros

​Pré-requisitos

​Padrão de integração recomendado

​Resposta

​Erros

​Próximos passos

Comitê de Crédito IA

Consultar Pareceres

Consultar Deliberação

Criar Webhook

Quando usar

Autenticação

Parâmetros

Pré-requisitos

Padrão de integração recomendado

Resposta

Erros

Próximos passos