> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kinglog.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Consulta estruturada

> Executa uma consulta validada (fields, include, where, orderBy, pagination) em uma entidade do registry. Somente leitura, escopo do usuário.

Executa uma consulta validada (fields, include, where, orderBy, pagination) em uma entidade do registry. Somente leitura, escopo do usuário.

```text theme={null}
POST /ai/query/run
```

| Campo | Valor |
| - | - |
| Identificador | `ai.query.run` |
| Efeito | leitura |
| Domínio | Consultas |

Exige `Authorization: Bearer` com o JWT da conta. Onde o caminho ou o corpo pedem `companyId` e `userId`, use a empresa e o usuário dessa sessão.

**Corpo**

entity obrigatório; query opcional com fields, include, where, orderBy e pagination. Use ai.query.describe para ver campos e operadores.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.