ynab_update_category
Set a new budgeted amount for a YNAB category in the current month. Provide funding in decimal currency or milliunits, and optionally preview with a dry run before saving.
Instructions
Update the budgeted amount for a category in the current month.
Args:
budget_id (string, optional): Budget UUID. Omit to use the default budget.
category_id (string, required): Category UUID.
budgeted_decimal (number, preferred): New funding amount in decimal currency units.
budgeted_milliunits (int, alternative): Explicit raw YNAB milliunits.
budgeted (int, deprecated): Backward-compatible alias for budgeted_milliunits.
dry_run (boolean, optional): Preview without saving. Default: false.
Returns: updated category with new budgeted, activity, balance.
Examples:
Budget $100: set budgeted_decimal=100.00
Already-converted data: set budgeted_milliunits=100000
Dry run: set dry_run=true
Errors:
"No default budget set" → run ynab_set_default_budget first
Write safety: call without confirmation_token to preview. Execute the identical validated request with the short-lived confirmation_token returned by that preview.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dry_run | No | ||
| budgeted | No | Deprecated legacy alias for budgeted_milliunits. Use budgeted_decimal or budgeted_milliunits. | |
| budget_id | No | ||
| category_id | Yes | ||
| budgeted_decimal | No | Preferred: category funding amount in decimal currency units (for example, 100.00). | |
| confirmation_token | No | Short-lived, single-use token returned by the immediately preceding preview of this exact validated request. | |
| budgeted_milliunits | No | Raw YNAB category funding amount in milliunits. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||