Delete a budget
delete_budgetChanges- What it does
- Changes or deletes something you had. Your assistant can ask you to confirm first. Safe to retry: the same call twice changes nothing more.
- Permission
- Budgets, change
budgets:write
What your assistant is told
Remove a monthly spending cap for a category — use when the user wants to CLEAR/unset a budget ("stop tracking a budget for Groceries", "delete that cap"). budget_id is the budget row's UUID; get it from get_budgets for the month in question (the id is on each row). Deleting a cap touches no transactions — it only removes the advisory limit; spend already logged stays. Returns the deleted id. To CHANGE a cap instead of clearing it, call set_budget again (it upserts the cap for that category+month).
Parameters
budgetIdid, requiredUUID of the budget cap row to delete. Useget_budgetsfor the month to find it.