Skip to main content
POST
/
entities
/
{id}
/
report-export
/
email
Relatório PDF da entidade por e-mail
curl --request POST \
  --url http://api.gu1.ai/entities/{id}/report-export/email \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --header 'X-Organization-ID: <x-organization-id>' \
  --data '
{
  "recipientEmails": [
    "<string>"
  ],
  "emailLocale": "<string>",
  "sections": {}
}
'

Documentation Index

Fetch the complete documentation index at: https://docs.gu1.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Visão geral

Enfileira de forma assíncrona a geração do PDF da entidade no servidor e o envio por e-mail. O PDF usa o mesmo fluxo jsPDF do download “exportar relatório” no app. Sua integração chama o endpoint com API key; os destinatários recebem o anexo (assunto/corpo conforme emailLocale).
A resposta HTTP é 202 Accepted assim que o trabalho é enfileirado. Geração e envio ocorrem em segundo plano; falhas ficam nos logs do servidor.

​
Endpoint

POST http://api.gu1.ai/entities/{id}/report-export/email

​
Autenticação e tenant

​
Authorization
string
required
Bearer SUA_API_KEY — ver Autenticação.
​
X-Organization-ID
string
required
UUID da organização (produção ou sandbox) — ver Ambientes.

​
Permissões

Exige permissão granular entities:export na API key (igual a POST /entities/{id}/export e GET /entities/{id}/export-data).

​
Parâmetros de rota

​
id
string
required
UUID da entidade (id retornado por criar/listar/obter).

​
Corpo JSON

​
recipientEmails
string[]
required
Um ou mais e-mails (máx. 26 após deduplicação). O e-mail da conta autenticada é mesclado automaticamente quando existir (deduplicado).
​
emailLocale
string
Idioma do e-mail: en, es ou pt. Padrão en se omitido ou inválido.
​
sections
object
required
Booleanos por seção do relatório (mesma semântica do modal de exportação). Chaves opcionais; padrões alinhados ao validador da API (generalInfo padrão true, demais false se omitidos).Chaves: generalInfo, kyc, documents, checks, enrichments, alerts, aiAnalysis, relationships, timeline, riskAnalysis.

​
Exemplo de corpo

{
  "recipientEmails": ["compliance@exemplo.com"],
  "emailLocale": "pt",
  "sections": {
    "generalInfo": true,
    "riskAnalysis": true,
    "enrichments": true
  }
}

​
Exemplo curl

curl -X POST "http://api.gu1.ai/entities/550e8400-e29b-41d4-a716-446655440000/report-export/email" \
  -H "Authorization: Bearer SUA_API_KEY" \
  -H "X-Organization-ID: UUID_DA_ORG" \
  -H "Content-Type: application/json" \
  -d '{
    "recipientEmails": ["compliance@exemplo.com"],
    "emailLocale": "pt",
    "sections": {
      "generalInfo": true,
      "riskAnalysis": true,
      "enrichments": true
    }
  }'

​
Respostas

​
202 Accepted — enfileirado

{
  "success": true,
  "status": "queued",
  "message": "…"
}

​
400 / 404 / 500

Mesmos padrões da documentação em inglês: validação, entidade inexistente ou oculta, erro interno.

​
Endpoints relacionados

  • POST /entities/{id}/export — download síncrono do PDF.
  • GET /entities/{id}/export-data — JSON usado pelo painel; o PDF por e-mail usa a mesma montagem de dados no servidor.
  • Obter entidade — GET /entities/{id}.