---
title: "POST AI Generate report"
method: POST
path: "/api/files/ai/generate-report"
---

# POST AI Generate report

`POST /api/files/ai/generate-report`

## Request

- Base URL: `https://app.plugsign.com.br`
- URL: `https://app.plugsign.com.br/api/files/ai/generate-report`
- Auth: API key in header `Authorization`

Gera uma **análise com até 10 sugestões** sobre o conteúdo do documento, feita pelo Astro.

*   A resposta vem em `message`, em HTML simples, já com a saudação do Astro e o nome do documento.
*   O documento é marcado como tendo relatório gerado e a análise fica registrada.

## Request body

- object
  - `provider` 'openai', required: Provedor de IA. Único valor aceito: openai.
  - `model` 'gpt-4o-mini', required: Modelo. Único valor aceito: gpt-4o-mini.
  - `document_key` string, required: Document Key de um documento da sua empresa.

## Response `200`

Relatório gerado

- object
  - `message` string: Texto do relatório em HTML simples.

## Other responses

- `403`: IA não habilitada para o usuário do token
- `422`: Erro de validação
- `500`: Falha ao obter a resposta do assistente

## Changes

- **2026-11-03** `3db1513040ea`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/plugsign/apis/endpoints-manuais/changes/api/files/ai/generate-report/post.md)

---

[API](https://skmtc.dev/plugsign/apis/endpoints-manuais.md) - [All operations](https://skmtc.dev/plugsign/apis/endpoints-manuais/llms.txt) - [OpenAPI document](https://skmtc.dev/plugsign/apis/endpoints-manuais/revisions/3db1513040ea?raw)