Update a category

update_categoryChanges

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: Transactions, change transactions:write

What your assistant is told

Rename or restyle one of the user's OWN custom categories — change its name, emoji icon, or color. category_id is the category's UUID (from list_categories). SPARSE patch: pass only what changes; omitted fields keep their current value (pass an empty string "" for icon/color to clear that field). System DEFAULT categories (Groceries, Rent, …) are read-only — an edit attempt is rejected with a clear error. Renaming does not move a category's transactions; they follow it. name must stay unique. Returns the updated category.

Parameters

categoryIdid, requiredUUID of the custom category to edit. Use list_categories to find it (defaults are read-only).
nametext, optionalNew unique category name. Omit to keep the current name.
icontext, optionalNew emoji icon. Omit to keep unchanged; pass "" to clear.
colortext, optionalNew hex color like "#3366FF". Omit to keep unchanged; pass "" to clear.