delete_category
Permanently delete a category by ID. This is destructive — if the category has linked transactions you must supply replaceWithCategoryId to reassign them first, otherwise the call will fail. Cannot delete a parent category that still has subcategories. Check the transaction count with get_category_transaction_count first. Only call when the user explicitly confirms deletion. Requires finance:delete 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": "delete_category"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| categoryId | Yes | ID of the category to delete. | |
| replaceWithCategoryId | No | ID of the category to reassign linked transactions to. Required when the category has transactions. |