update_category
Update an existing category by ID. Use when the user wants to rename, recolor, re-icon, move or set the default tags of a category. Returns the updated category records. Requires finance:write scope.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"categoryId": "<categoryId>"
},
"name": "update_category"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| icon | No | New icon identifier, or null to clear it. | |
| name | No | New category name. | |
| color | No | New hex color code (e.g. "#4CAF50"). | |
| parentId | No | Move under this parent category ID, or null to make it top-level. Omit to keep it where it is | |
| categoryId | Yes | ID of the category to update. | |
| defaultTagIds | No | Replaces the default tags (IDs from get_tags); [] clears them. Max 20 | |
| applyDefaultTagsOnAiCategorization | No | true also applies defaultTagIds when AI categorization picks this category |