Sign in
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

Changes

Changed in 3 of the 48 revisions of this API.15

  • 99490d1e837e13See the full diff
    • ●

      removed the optional property agents/items/week_to_date_cost from the response with the 200 status

      response-optional-property-removed

    • ○

      added the new optional query request parameter sort_by

      new-optional-request-parameter

    • ○

      added the new optional query request parameter sort_order

      new-optional-request-parameter

    • ○

      added the optional property agents/items/model_name to the response with the 200 status

      response-optional-property-added

    This revision also has 15 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • f5481e7704161See the full diff
    • ○

      added the optional property agents/items/agent_name to the response with the 200 status

      response-optional-property-added

  • e86be67718ee1See the full diff
    • ○

      endpoint added

      endpoint-added