List fleet users with usage

Returns the top users with aggregated cost data for the given time window. Defaults to sorting by cost descending; pass sort_by and sort_order to change.

GET /v1/platform/fleet/usage/users

Error

A valid request URL is required to generate request examples

200

{
  "users": [
    {
      "agent_count": 123,
      "first_used": "<string>",
      "last_used": "<string>",
      "ls_user_id": "<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, agent_count, last_used, first_used)

sort_order · string · default: desc

Sort direction (asc, desc)

Response

200

application/json

OK

users · object[]

Show child attributes