Skip to main content
GET
/
api
/
agent-runs
cURL
curl --request GET \
  --url https://app.cotool.ai/api/agent-runs \
  --header 'Authorization: Bearer <token>'
"<any>"

Authorizations

​
Authorization
string
header
required

API Key authentication for programmatic access. Include your API key in the Authorization header as: Bearer your_api_key_here

Query Parameters

​
page
number
default:0

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

Required range: x >= 0
​
pageSize
number
default:50

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

Required range: 1 <= x <= 100
​
sortField
enum<string>
default:createdAt

Field to sort by (default: createdAt)

Available options:
createdAt,
updatedAt,
agentName,
modelAlias,
evalScore
​
sortDirection
enum<string>
default:desc

Sort direction (default: desc)

Available options:
asc,
desc
​
agentIdFilter
string<uuid>

Optional filter by exact agent id

​
agentNameFilter
string

Optional filter by agent name (partial match)

​
toolFilter
string

Optional comma-separated list of tool names to filter by

​
dateFrom
string

Optional start date filter (ISO string)

​
dateTo
string

Optional end date filter (ISO string)

​
triggerSourceFilter
string

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

​
scoreFilters
string

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

Response

200 - application/json

Successful response

Paginated list of agent execution runs with filtering and sorting