List fleet tools with usage

Returns the top tools in the workspace with run counts, latency, and agent counts for the given time window. Defaults to sorting by runs descending; pass sort_by and sort_order to change.

GET /v1/platform/fleet/usage/tools

Error

A valid request URL is required to generate request examples

200

{
  "tools": [
    {
      "agent_count": 123,
      "avg_latency_ms": 123,
      "last_used": "<string>",
      "run_count": 123,
      "tool_name": "<string>"
    }
  ]
}

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 window (ISO8601)

end_time · string · required

End of window (ISO8601)

sort_by · string · default: runs

Sort field (runs, avg_latency_ms, agent_count, last_used)

sort_order · string · default: desc

Sort direction (asc, desc)

Response

200

application/json

OK

tools · object[]

Show child attributes