Gets the agent's per-tool usage rollup for the operator overview card.
Returns one entry per tool (invocations, errors, cost, durations), ordered by invocation count descending, over the requested origin + window. Null/null window covers all time; otherwise it defaults to 30 days before to, mirroring the cost-timeseries windowing so the surfaces reconcile.
Authorization
Bearer JWT Authorization header using the Bearer scheme. Enter 'Bearer' [space] and then your token.
In: header
Path Parameters
The unique identifier of the agent.
The tenant identifier
Query Parameters
Execution origin to roll up. Defaults to PRODUCTION.
"PRODUCTION""UNSPECIFIED" | "PRODUCTION" | "TEST"Optional window start as Unix milliseconds (inclusive).
int64Optional window end as Unix milliseconds (exclusive). Defaults to now when a window is requested.
int64Optional environment slug to scope the rollup to.
Response Body
curl -X GET "https://api.fruxon.com/v1/tenants/string/agents/string/toolUsage"{
"tools": [
{
"toolIntegrationId": "string",
"toolId": "string",
"toolType": "API",
"displayName": "string",
"invocations": 0,
"errors": 0,
"cost": 0,
"totalDurationMs": 0,
"toolKey": "string.string",
"errorRate": null,
"avgDurationMs": null
}
],
"totalInvocations": 0,
"totalCost": 0,
"toolCount": 1
}{
"type": "string",
"title": "string",
"status": 0,
"detail": "string",
"instance": "string",
"property1": null,
"property2": null
}Gets how much work the agent's hand-offs were for the team, bucketed over time.
A hand-off is counted once it closed and the team's exchange with the customer is on record; until then it is `pending`. Each is split three ways: `withoutAsking` — the team answered and finished without needing anything from the customer; `asked` — the customer wrote between the team's first and last message, so the team waited on an answer; `noReply` — nobody answered in the chat. Each hand-off is counted in the bucket it opened in; buckets with none are omitted. Counting stops where the workspace's run history does, as the conversations series' does, so a window reaching further back is counted from `countedFromMs`. `measured` is false for an agent none of whose hand-offs has ever been measured — one whose escalations go where the team's replies are never seen.
Gets the change history for an agent.
Returns a chronological list of all changes made to the agent, including configuration updates, deployments, and metadata changes.