v48

latestOpenAPI 3.1.0raw.githubusercontent.com2026-05-275867561.6 MB
fleet usage

List fleet agents with usage

Returns the top agents in the workspace with cost data for the given time window. Defaults to sorting by cost descending; pass sort_by and sort_order to change. Data is sourced entirely from ClickHouse run metadata.

get/v1/platform/fleet/usage/agents

Query parameters

limitinteger

Max results (max 100)

start_timestring required

Start of cost window (ISO8601)

end_timestring required

End of cost window (ISO8601)

sort_bystring

Sort field (cost, runs, last_used, first_used)

sort_orderstring

Sort direction (asc, desc)

Response

OK