# Filtrar histórico do agente

Este endpoint permite filtrar o histórico por agente (obrigatório), usuário, tipo de ação e período. Suporta paginação.

Source: https://zild.ai/pt-BR/docs/api-reference/post-api-AgentHistory-filter

POST `/AgentHistory/filter`

Este endpoint permite filtrar o histórico por agente (obrigatório), usuário, tipo de ação e período. Suporta paginação.

## Autenticação

**Autenticação obrigatória.** Envie sua chave de API de usuário no header X-API-Key.

## Parâmetros

Esta operação não possui parâmetros de rota, query ou header.

## Corpo da requisição

**Content type:** `application/json` · **Schema:** `AgentHistoryFilterDto`



<table class="api-params"><thead><tr><th>Propriedade</th><th>Tipo</th><th>Obrigatório</th><th>Descrição</th><th>Restrições</th></tr></thead><tbody><tr><td><code>agentId</code></td><td><code>integer · int32</code></td><td>Sim</td><td>—</td><td>—</td></tr><tr><td><code>userId</code></td><td><code>integer · int32</code></td><td>Não</td><td>—</td><td>aceita null</td></tr><tr><td><code>actionType</code></td><td><code>AgentHistoryActionType</code></td><td>Não</td><td>—</td><td>—</td></tr><tr><td><code>createdAtStart</code></td><td><code>string · date-time</code></td><td>Não</td><td>—</td><td>aceita null</td></tr><tr><td><code>createdAtEnd</code></td><td><code>string · date-time</code></td><td>Não</td><td>—</td><td>aceita null</td></tr><tr><td><code>page</code></td><td><code>integer · int32</code></td><td>Não</td><td>—</td><td>—</td></tr><tr><td><code>pageSize</code></td><td><code>integer · int32</code></td><td>Não</td><td>—</td><td>—</td></tr></tbody></table>



## Exemplo de requisição



```
curl --request POST \
  --url 'https://api.zild.ai/AgentHistory/filter' \
  --header 'X-API-Key: YOUR_USER_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "agentId": 0,
  "userId": 0,
  "actionType": 0,
  "createdAtStart": "2026-09-22T18:00:00Z",
  "createdAtEnd": "2026-09-22T18:00:00Z",
  "page": 0,
  "pageSize": 0
}'
```



## Respostas



<table class="api-params"><thead><tr><th>Status</th><th>Descrição</th><th>Corpo da resposta</th></tr></thead><tbody><tr><td><code>200</code></td><td>Sucesso ao retornar o histórico filtrado</td><td><code>application/json</code> · <code>AgentHistoryPagedResultDto</code></td></tr><tr><td><code>400</code></td><td>AgentId é obrigatório</td><td>Nenhum corpo de resposta está definido.</td></tr></tbody></table>

**Exemplo de resposta (200):**



```
{
  "items": [
    {
      "id": 0,
      "agentId": 0,
      "agentName": "string",
      "userId": 0,
      "userName": "string",
      "userEmail": "string",
      "actionType": 0,
      "actionTypeDescription": "string",
      "description": "string",
      "previousState": "string",
      "newState": "string",
      "changedFields": "string",
      "createdAt": "2026-09-22T18:00:00Z",
      "version": 0
    }
  ],
  "totalCount": 0,
  "page": 0,
  "pageSize": 0,
  "totalPages": 0,
  "hasNextPage": true,
  "hasPreviousPage": true
}
```



## Modelos de dados

`AgentHistoryActionType`0 = Created; 1 = Updated; 2 = Deleted; 3 = FileAdded; 4 = FileRemoved; 5 = DynamicVariableAdded; 6 = DynamicVariableUpdated; 7 = DynamicVariableRemoved; 8 = DataCollectionAdded; 9 = DataCollectionUpdated; 10 = DataCollectionRemoved; 11 = ToolAdded; 12 = ToolUpdated; 13 = ToolRemoved; 14 = TaskAdded; 15 = TaskUpdated; 16 = TaskRemoved; 17 = PermissionChanged

`integer`

`AgentHistoryDto`

<table class="api-params"><thead><tr><th>Propriedade</th><th>Tipo</th><th>Obrigatório</th><th>Descrição</th><th>Restrições</th></tr></thead><tbody><tr><td><code>id</code></td><td><code>integer · int32</code></td><td>Não</td><td>—</td><td>—</td></tr><tr><td><code>agentId</code></td><td><code>integer · int32</code></td><td>Não</td><td>—</td><td>—</td></tr><tr><td><code>agentName</code></td><td><code>string</code></td><td>Não</td><td>—</td><td>aceita null</td></tr><tr><td><code>userId</code></td><td><code>integer · int32</code></td><td>Não</td><td>—</td><td>—</td></tr><tr><td><code>userName</code></td><td><code>string</code></td><td>Não</td><td>—</td><td>aceita null</td></tr><tr><td><code>userEmail</code></td><td><code>string</code></td><td>Não</td><td>—</td><td>aceita null</td></tr><tr><td><code>actionType</code></td><td><code>AgentHistoryActionType</code></td><td>Não</td><td>—</td><td>—</td></tr><tr><td><code>actionTypeDescription</code></td><td><code>string</code></td><td>Não</td><td>—</td><td>aceita null</td></tr><tr><td><code>description</code></td><td><code>string</code></td><td>Não</td><td>—</td><td>aceita null</td></tr><tr><td><code>previousState</code></td><td><code>string</code></td><td>Não</td><td>—</td><td>aceita null</td></tr><tr><td><code>newState</code></td><td><code>string</code></td><td>Não</td><td>—</td><td>aceita null</td></tr><tr><td><code>changedFields</code></td><td><code>string</code></td><td>Não</td><td>—</td><td>aceita null</td></tr><tr><td><code>createdAt</code></td><td><code>string · date-time</code></td><td>Não</td><td>—</td><td>—</td></tr><tr><td><code>version</code></td><td><code>integer · int32</code></td><td>Não</td><td>—</td><td>—</td></tr></tbody></table>

`AgentHistoryFilterDto`

<table class="api-params"><thead><tr><th>Propriedade</th><th>Tipo</th><th>Obrigatório</th><th>Descrição</th><th>Restrições</th></tr></thead><tbody><tr><td><code>agentId</code></td><td><code>integer · int32</code></td><td>Sim</td><td>—</td><td>—</td></tr><tr><td><code>userId</code></td><td><code>integer · int32</code></td><td>Não</td><td>—</td><td>aceita null</td></tr><tr><td><code>actionType</code></td><td><code>AgentHistoryActionType</code></td><td>Não</td><td>—</td><td>—</td></tr><tr><td><code>createdAtStart</code></td><td><code>string · date-time</code></td><td>Não</td><td>—</td><td>aceita null</td></tr><tr><td><code>createdAtEnd</code></td><td><code>string · date-time</code></td><td>Não</td><td>—</td><td>aceita null</td></tr><tr><td><code>page</code></td><td><code>integer · int32</code></td><td>Não</td><td>—</td><td>—</td></tr><tr><td><code>pageSize</code></td><td><code>integer · int32</code></td><td>Não</td><td>—</td><td>—</td></tr></tbody></table>

`AgentHistoryPagedResultDto`

<table class="api-params"><thead><tr><th>Propriedade</th><th>Tipo</th><th>Obrigatório</th><th>Descrição</th><th>Restrições</th></tr></thead><tbody><tr><td><code>items</code></td><td><code>array&lt;AgentHistoryDto&gt;</code></td><td>Não</td><td>—</td><td>aceita null</td></tr><tr><td><code>totalCount</code></td><td><code>integer · int32</code></td><td>Não</td><td>—</td><td>—</td></tr><tr><td><code>page</code></td><td><code>integer · int32</code></td><td>Não</td><td>—</td><td>—</td></tr><tr><td><code>pageSize</code></td><td><code>integer · int32</code></td><td>Não</td><td>—</td><td>—</td></tr><tr><td><code>totalPages</code></td><td><code>integer · int32</code></td><td>Não</td><td>—</td><td>—</td></tr><tr><td><code>hasNextPage</code></td><td><code>boolean</code></td><td>Não</td><td>—</td><td>—</td></tr><tr><td><code>hasPreviousPage</code></td><td><code>boolean</code></td><td>Não</td><td>—</td><td>—</td></tr></tbody></table>