FruxonDocs
AgentsBudget

Lists every budget configured for an agent — one per origin.

One round-trip for the studio budget panel: returns both Production and Test budgets when set, in a single array. An empty array means the agent runs uncapped on all origins. The single-origin M:Fruxon.Server.Controllers.AgentBudgetController.Get(System.String,Fruxon.Model.AgentSessions.ExecutionOrigin) endpoint is still the right call when you only care about one bucket (e.g. enforcement checks); this one is for rendering the side-by-side configuration UI.

GET
/v1/tenants/{tenant}/agents/{agent}/budget/all

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 agent ID.

tenant*string

The tenant identifier

Response Body

curl -X GET "https://api.fruxon.com/v1/tenants/string/agents/string/budget/all"
[
  {
    "agentId": "string",
    "origin": "PRODUCTION",
    "amount": 0,
    "thresholdRules": [
      {
        "percent": 0
      }
    ],
    "enforceLimit": false,
    "currentMonthlyCost": 0,
    "usagePercent": 0,
    "periodStart": 0,
    "periodEnd": 0,
    "createdAt": 0,
    "modifiedAt": 0
  }
]
Empty
Empty
Empty

Gets the budget configuration for an agent, including current cost and usage data

Returns the budget cap, period, alert thresholds, and the live cost accumulated against the current period (sourced from the same execution-cost stream that powers `GET /v1/tenants/{tenant}/agents/{agent}/revisions/{revision}/cost`). A `null` response body means the agent has no budget enforcement and runs are uncapped. A 404 here means the agent id is invalid or the caller has no access to it — not that the budget is unset. Use this to drive budget UI and to check headroom before kicking off expensive batches.

Removes the budget configuration for an agent

Drops all spend enforcement and alert thresholds for the agent; subsequent executions run without a cost cap. Historical cost data is unaffected and remains queryable through the revision cost endpoints. Idempotent — returns 204 whether or not a budget was configured beforehand.