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.
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 revision number, or * to aggregate across all revisions.
The tenant identifier
Query Parameters
Optional environment slug to filter costs by.
Execution origin to roll up. Defaults to PRODUCTION — existing
dashboards see no behavior change after draft tests start landing in
the cost ledger. Pass TEST for developer test spend.
"UNSPECIFIED" | "PRODUCTION" | "TEST"Response Body
curl -X GET "https://api.fruxon.com/v1/tenants/string/agents/string/revisions/string/cost"{
"agentId": "string",
"revision": 0,
"inputCost": 0,
"outputCost": 0,
"totalCost": 0,
"executionCount": 0,
"inputTokens": 0,
"outputTokens": 0
}{
"type": "string",
"title": "string",
"status": 0,
"detail": "string",
"instance": "string",
"property1": null,
"property2": null
}Updates an existing agent
Patches top-level agent metadata (display name, description, etc.). This does not touch the flow definition or any revision — to change the executable behavior, edit the draft revision and redeploy. The update is applied to the live agent record immediately and is visible to all collaborators on the next read. Returns 404 if the agent has been deleted or is still in the deletion grace period from another caller.
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.