FruxonDocs
AgentsRevisions

Gets the agent revision cost summed across every environment.

Use `*` as the revision parameter to aggregate across all revisions. Cost buckets with no LLM usage are omitted from the response; execution-count buckets are independent and surface failures that occurred before any LLM call.

GET
/v1/tenants/{tenant}/agents/{agent}/revisions/{revision}/costTimeseries

Authorization

Bearer
AuthorizationBearer <token>

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

In: header

Path Parameters

agent*string

Agent identifier.

revision*string

Revision number, or * for all revisions.

tenant*string

The tenant identifier

Query Parameters

interval?string

Bucket granularity (hour, day, week). Defaults to day.

Value in"UNSPECIFIED" | "HOUR" | "DAY" | "WEEK"
from?integer

Window start as Unix milliseconds (inclusive). Defaults to 30 days before to.

Formatint64
to?integer

Window end as Unix milliseconds (exclusive). Defaults to now.

Formatint64
origin?string

Execution origin to roll up. Defaults to PRODUCTION. Pass TEST for developer test spend.

Value in"UNSPECIFIED" | "PRODUCTION" | "TEST"

Response Body

curl -X GET "https://api.fruxon.com/v1/tenants/string/agents/string/revisions/string/costTimeseries"
{
  "agentId": "string",
  "revision": 0,
  "interval": "HOUR",
  "window": {
    "fromMs": 0,
    "toMs": 0
  },
  "cost": [
    {
      "bucketStartMs": 0,
      "cost": {
        "input": 0,
        "output": 0,
        "total": 0
      },
      "tokens": {
        "input": 0,
        "output": 0
      }
    }
  ],
  "executions": [
    {
      "bucketStartMs": 0,
      "count": 0
    }
  ]
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}
Empty
Empty
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}

Gets aggregated cost for a specific agent revision or all revisions.

Returns cost information including total input/output costs, token usage, and execution count. Use `*` as the revision parameter to aggregate costs across all revisions.

Deploys an agent revision, making it the active version.

All subsequent executions will use this revision's configuration. Connectors that don't require manual webhook setup are automatically activated.