FruxonDocs
ApiTenants

Gets the tenant's per-tool usage rollup across all of its agents.

Returns one entry per tool (invocations, errors, cost, durations) plus headline totals, 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 per-agent endpoint so the surfaces reconcile.

GET
/v1/tenants/{tenant}/toolUsage

Authorization

Bearer
AuthorizationBearer <token>

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

In: header

Path Parameters

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/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
}