---
title: "POST AI Ask about document"
method: POST
path: "/api/files/ai/ask"
---

# POST AI Ask about document

`POST /api/files/ai/ask`

## Request

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

Faz uma **pergunta sobre o conteúdo do documento** ao Astro.

*   A resposta vem em `message`, em HTML simples, com o prefixo `<b>AI:</b>`.
*   A resposta também é registrada no chat do documento, como mensagem do Astro.
*   Se não for possível extrair o texto do documento, `message` vem como `false`.

## 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.
  - `question` string, required: Pergunta sobre o documento.
  - `document_key` string, required: Document Key de um documento da sua empresa.

## Response `200`

Resposta do assistente

- object
  - `message` string: Resposta em HTML simples.

## Other responses

- `403`: IA não habilitada para o usuário do token
- `422`: Erro de validação
- `500`: Falha na comunicação com o assistente

## Changes

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

[Operation history](https://skmtc.dev/plugsign/apis/endpoints-manuais/changes/api/files/ai/ask/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)