Audit Logs

Count audit logs

Return the total number of audit-log records that match a set of optional filters.

get/api/audit-logs/count

Request

  • Base URL
    https://app.cotool.ai
  • Auth
    HTTP bearer

Query parameters

userIdstring

Count audit logs for specific user ID

eventstring

Count audit logs for specific event type (e.g., user.login, agent.runStarted)

actorstring

Count audit logs for specific actor type (user, agent, chat)

chatIdstring

Count audit logs for specific chat ID

agentIdstring

Count audit logs for specific agent ID

triggerIdstring

Count audit logs for specific trigger ID

toolGroupstring

Count audit logs for a specific tool family (matches data.toolId equal to the value or starting with "<value>_")

mcpConnectionIdstring uuid

Count audit logs for one MCP app connection (via.connectionId or data.mcpApp.connectionId)

startDatestring

Count audit logs from this date onwards (ISO string format)

endDatestring

Count audit logs up to this date (ISO string format)

searchstring

Text search across event type, actor, user email, agent name, and data fields

Response

Successful response

countnumber required

Total number of audit log entries matching the specified filters

Changes

No recorded changes to this operation across all 2 revisions of this API.