FruxonDocs
AgentsRevisions

Gets agent revision cost bucketed over time.

Use `*` as the revision parameter to aggregate across all revisions. Buckets with no activity are omitted from the response — clients should treat missing buckets as zero.

GET
/v1/tenants/{tenant}/agents/{agent}/revisions/{revision}/cost/timeseries

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.

revision*string

The revision number, or * to aggregate across 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
environment?string

Optional environment slug filter.

Response Body

curl -X GET "https://api.fruxon.com/v1/tenants/string/agents/string/revisions/string/cost/timeseries"
{
  "agentId": "string",
  "revision": 0,
  "interval": "HOUR",
  "from": 0,
  "to": 0,
  "points": [
    {
      "bucketStart": 0,
      "inputCost": 0,
      "outputCost": 0,
      "totalCost": 0,
      "inputTokens": 0,
      "outputTokens": 0,
      "executionCount": 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.