Agent Runs

List agent runs

Retrieve a paginated list of historical agent execution runs with optional filters.

get/api/agent-runs

Request

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

Query parameters

pagenumber

Page number for pagination (0-based, default: 0)

pageSizenumber

Number of runs per page (1-100, default: 50)

sortField'createdAt' | 'updatedAt' | 'agentName' | 'modelAlias' | 'evalScore' | 'durationMs'

Field to sort by (default: createdAt)

sortDirection'asc' | 'desc'

Sort direction (default: desc)

agentIdFilterstring uuid

Optional filter by exact agent id

agentNameFilterstring

Optional filter by agent name (partial match)

searchQuerystring

Optional search across execution ID, run/alert title, and agent name (partial match)

toolFilterstring

Optional comma-separated list of tool names to filter by

dateFromstring

Optional start date filter (ISO string)

dateTostring

Optional end date filter (ISO string)

triggerSourceFilterstring

Optional comma-separated list of trigger source values (manual, jira, slack, etc.)

scoreFiltersstring

Optional JSON array of { op: gt|lt|eq|ge|le, value: number } for eval score filtering (applied as OR)

noteworthyFilterstring

When true, only return noteworthy runs: those with critical issues, failed acceptance criteria, or high/critical severity detection hits

needsAttentionFilterstring

When true, only return runs with critical issues or failed acceptance criteria

includeTotalCountstring

When false, skip the exact pagination count and return zero for totalCount

Response

Successful response

totalCountinteger required

Total number of runs matching the filters (for pagination)

Changes

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