FruxonDocs
AgentsExecution Records

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.

GET
/v1/tenants/{tenant}/agents/{agent}/toolUsage

Authorization

Bearer
AuthorizationBearer <token>

JWT Authorization header using the Bearer scheme. Enter 'Bearer' [space] and then your token.

In: header

Path Parameters

agent*string

The unique identifier of the agent.

tenant*string

The tenant identifier

Query Parameters

origin?string

Execution origin to roll up. Defaults to PRODUCTION.

Value in"UNSPECIFIED" | "PRODUCTION" | "TEST"
from?integer

Optional window start as Unix milliseconds (inclusive).

Formatint64
to?integer

Optional window end as Unix milliseconds (exclusive). Defaults to now when a window is requested.

Formatint64
environment?string

Optional 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
}
Empty
Empty
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}

Gets the agent's relevance-gate decision counts for the operator overview card.

Returns responded / silenced / budget-bypassed counts (and a silence rate) 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.

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.