budget cap

The budget cap command group operates on the monthlyCapUsd field of an app's budget config. Currently exposes a single subcommand: raise. Lowering or removing the cap is done through convox budget set or convox budget clear.

budget cap raise

Raise the monthly cap. Atomic with breaker-clear when the new cap is above current spend.

Requires admin role on the rack. A non-admin caller (rw role) receives 403 AppBudgetSet: admin role required to set budget cap. Basic-auth (rack-password) callers automatically pass the admin check.

Usage

    convox budget cap raise <app> --monthly-cap-usd N

Examples

    $ convox budget cap raise myapp --monthly-cap-usd 500
    Raising monthly cap for myapp... OK

If the new cap is below current spend, the CLI prints a warning and the Rack saves the cap anyway, so it trips again on the next accumulator tick:

    $ convox budget cap raise myapp --monthly-cap-usd 100
    WARNING: --monthly-cap-usd=$100.00 is below current month-to-date spend $134.65. Cap will trip immediately on next accumulator tick.
    Raising monthly cap for myapp... OK

Use convox cost --app myapp to confirm current spend before raising.

Raising the cap does not restart services that auto-shutdown scaled to zero. Run convox budget reset myapp right after the raise to restore them.

See Also

• budget: full budget command group
• budget reset: acknowledge cap breach without raising
• Cap raise: operational guide