create_budget
Destructive
Create a new cloud budget with spending limits and alert thresholds to control costs.
Instructions
Use this when the user wants to create a new cloud budget with spending limits and alert thresholds. Requires budget name, currency, type, and start period. Ask the user to confirm the budget parameters before executing. Do NOT use this for viewing existing budgets (use list_budgets or get_budget) or creating alerts (use create_alert).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Budget name (required, non-empty). | |
| type | Yes | Budget type (required). Accepted values: fixed, recurring. | |
| scope | No | List of allocations that define the budget scope (deprecated). Exactly one of scope or scopes must be provided. | |
| alerts | No | List of up to three alert thresholds defined as a percentage of the amount. | |
| amount | No | Budget period amount. Required if usePrevSpend is false. | |
| metric | No | Budget metric. Accepted values: cost, amortized_cost. Defaults to cost. | |
| public | No | Public sharing access level. Accepted values: owner, editor, viewer. | |
| scopes | No | Filters that define the scope of the budget. Exactly one of scope or scopes must be provided. | |
| currency | Yes | Currency code (required). Accepted values: USD, ILS, EUR, AUD, CAD, GBP, DKK, NOK, SEK, BRL, SGD, MXN, CHF, MYR, TWD, EGP, ZAR, JPY, IDR, AED, THB, COP. | |
| endPeriod | No | Fixed budget end date as a UNIX timestamp in milliseconds. Required if type is fixed, must not be set for recurring. | |
| recipients | No | List of email addresses to notify when reaching an alert threshold. | |
| description | No | Budget description. | |
| startPeriod | Yes | Budget start date as a UNIX timestamp in milliseconds (required). | |
| timeInterval | No | Recurring budget interval. Required for recurring budgets. Accepted values: day, week, month, quarter, year. | |
| usePrevSpend | No | Use the last period's spend as the target amount for recurring budgets. Defaults to false. | |
| collaborators | No | List of permitted users to view/edit the budget. If provided, must include at least one collaborator with role 'owner'. | |
| growthPerPeriod | No | Periodical growth percentage in recurring budgets. Must be >= 0. Defaults to 0. | |
| seasonalAmounts | No | List of seasonal amounts for recurring budgets with different amounts per period. | |
| recipientsSlackChannels | No | List of Slack channels to notify when reaching an alert threshold. |