organization_billing_budget_set

Tool

organization_billing_budget_set

Sets the monthly limit for extra charges of the organization that owns the product in product_id, in integer minor units, and what happens at 100%.

Sets the monthly limit for extra charges of the organization that owns the product in product_id, in integer minor units, and what happens at 100%. Replaces any existing limit. Does not end an open pause; organization_billing_budget_resume does. Returns: the budget view, as organization_billing_budgets_get. Typical sequence: organization_billing_budget_set → organization_billing_budget_resume. Fails when: the caller does not own the organization, or no currency is pinned for it yet (currency_not_pinned).

Behavior

HTTP: PUT /governance/api/v1/billing/budgets

Arguments

Name	Type	Required	Description
action	string	—	At 100%: "pause" stops chargeable compute and blocks new chargeable work until Resume; "alerts_only" only notifies. Default: "pause".
amount_minor	integer	•	Monthly limit for extra charges, in integer minor units of the organization currency. Example: 50000 = EUR 500.00.

Try it

Sets the monthly limit for extra charges of the organization that owns the product in product_id, in integer minor units, and what happens at 100%.

When to use

Example

Ask your agent something like this:

Sets the monthly limit for extra charges of the organization that owns the product in product_id, in integer minor units, and what happens at 100%.

The agent will invoke organization_billing_budget_set with these arguments:

{
  "amount_minor": "<amount_minor>"
}