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.

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

Propriedade	Tipo	Obrigatório	Descrição	Restrições
`agentId`	`integer · int32`	Sim	—	—
`userId`	`integer · int32`	Não	—	aceita null
`actionType`	`AgentHistoryActionType`	Não	—	—
`createdAtStart`	`string · date-time`	Não	—	aceita null
`createdAtEnd`	`string · date-time`	Não	—	aceita null
`page`	`integer · int32`	Não	—	—
`pageSize`	`integer · int32`	Não	—	—

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

Status	Descrição	Corpo da resposta
`200`	Sucesso ao retornar o histórico filtrado	`application/json` · `AgentHistoryPagedResultDto`
`400`	AgentId é obrigatório	Nenhum corpo de resposta está definido.

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

Propriedade	Tipo	Obrigatório	Descrição	Restrições
`id`	`integer · int32`	Não	—	—
`agentId`	`integer · int32`	Não	—	—
`agentName`	`string`	Não	—	aceita null
`userId`	`integer · int32`	Não	—	—
`userName`	`string`	Não	—	aceita null
`userEmail`	`string`	Não	—	aceita null
`actionType`	`AgentHistoryActionType`	Não	—	—
`actionTypeDescription`	`string`	Não	—	aceita null
`description`	`string`	Não	—	aceita null
`previousState`	`string`	Não	—	aceita null
`newState`	`string`	Não	—	aceita null
`changedFields`	`string`	Não	—	aceita null
`createdAt`	`string · date-time`	Não	—	—
`version`	`integer · int32`	Não	—	—

AgentHistoryFilterDto

Propriedade	Tipo	Obrigatório	Descrição	Restrições
`agentId`	`integer · int32`	Sim	—	—
`userId`	`integer · int32`	Não	—	aceita null
`actionType`	`AgentHistoryActionType`	Não	—	—
`createdAtStart`	`string · date-time`	Não	—	aceita null
`createdAtEnd`	`string · date-time`	Não	—	aceita null
`page`	`integer · int32`	Não	—	—
`pageSize`	`integer · int32`	Não	—	—

AgentHistoryPagedResultDto

Propriedade	Tipo	Obrigatório	Descrição	Restrições
`items`	`array<AgentHistoryDto>`	Não	—	aceita null
`totalCount`	`integer · int32`	Não	—	—
`page`	`integer · int32`	Não	—	—
`pageSize`	`integer · int32`	Não	—	—
`totalPages`	`integer · int32`	Não	—	—
`hasNextPage`	`boolean`	Não	—	—
`hasPreviousPage`	`boolean`	Não	—	—