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

Error

A valid request URL is required to generate request examples

200

{
  "agents": [
    {
      "agent_name": "<string>",
      "assistant_id": "<string>",
      "first_used": "<string>",
      "last_used": "<string>",
      "model_name": "<string>",
      "owner_email": "<string>",
      "run_count": 123,
      "total_cost": 123
    }
  ]
}

Authorizations

API KeyTenant IDBearer Auth

X-API-Key · string · header · required

Query Parameters

limit · integer · default: 20

Max results (max 100)

start_time · string · required

Start of cost window (ISO8601)

end_time · string · required

End of cost window (ISO8601)

sort_by · string · default: cost

Sort field (cost, runs, last_used, first_used)

sort_order · string · default: desc

Sort direction (asc, desc)

Response

200

application/json

OK

agents · object[]

Show child attributes