Filter agent history
Filter agent history. See the OpenAPI-defined parameters, request body, and responses below.
/AgentHistory/filterFilter agent history. See the OpenAPI-defined parameters, request body, and responses below.
OpenAPI description: Este endpoint permite filtrar o histórico por agente (obrigatório), usuário, tipo de ação e período. Suporta paginação.
Authentication
Authentication required. Send your user API key in the X-API-Key header.
Parameters
This operation has no path, query, or header parameters.
Request body
Content type: application/json · Schema: AgentHistoryFilterDto
| Property | Type | Required | Description | Constraints |
|---|---|---|---|---|
agentId | integer · int32 | Yes | — | — |
userId | integer · int32 | No | — | nullable |
actionType | AgentHistoryActionType | No | — | — |
createdAtStart | string · date-time | No | — | nullable |
createdAtEnd | string · date-time | No | — | nullable |
page | integer · int32 | No | — | — |
pageSize | integer · int32 | No | — | — |
Example request
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
}'
Responses
| Status | Description | Response body |
|---|---|---|
200 | Sucesso ao retornar o histórico filtrado | application/json · AgentHistoryPagedResultDto |
400 | AgentId é obrigatório | No response body is defined. |
Example response (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
}
Data models
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
| Property | Type | Required | Description | Constraints |
|---|---|---|---|---|
id | integer · int32 | No | — | — |
agentId | integer · int32 | No | — | — |
agentName | string | No | — | nullable |
userId | integer · int32 | No | — | — |
userName | string | No | — | nullable |
userEmail | string | No | — | nullable |
actionType | AgentHistoryActionType | No | — | — |
actionTypeDescription | string | No | — | nullable |
description | string | No | — | nullable |
previousState | string | No | — | nullable |
newState | string | No | — | nullable |
changedFields | string | No | — | nullable |
createdAt | string · date-time | No | — | — |
version | integer · int32 | No | — | — |
AgentHistoryFilterDto
| Property | Type | Required | Description | Constraints |
|---|---|---|---|---|
agentId | integer · int32 | Yes | — | — |
userId | integer · int32 | No | — | nullable |
actionType | AgentHistoryActionType | No | — | — |
createdAtStart | string · date-time | No | — | nullable |
createdAtEnd | string · date-time | No | — | nullable |
page | integer · int32 | No | — | — |
pageSize | integer · int32 | No | — | — |
AgentHistoryPagedResultDto
| Property | Type | Required | Description | Constraints |
|---|---|---|---|---|
items | array<AgentHistoryDto> | No | — | nullable |
totalCount | integer · int32 | No | — | — |
page | integer · int32 | No | — | — |
pageSize | integer · int32 | No | — | — |
totalPages | integer · int32 | No | — | — |
hasNextPage | boolean | No | — | — |
hasPreviousPage | boolean | No | — | — |