Actions38
- Budgets Actions
- Categories Actions
- Manual Accounts Actions
- Me Actions
- Plaid Accounts Actions
- Recurring Items Actions
- Summary Actions
- Tags Actions
- Transactions Actions
- Transactions Bulk Actions
- Transactions Files Actions
- Transactions Group Actions
- Transactions Split Actions
Categories → Delete Category
AI-generatedSummary
Delete a category by its ID, optionally forcing the deletion even if transactions are linked to the category.
Inputs
- Category ID (required) — The ID of the category to delete
- Force Delete — Whether to force the deletion even if there are transactions linked to the category (default is false).
Output shape
no body — success/failure only
The operation issues a DELETE request to the /categories/{id} endpoint with an optional query parameter 'force'. No data is returned on success, only a status indicating success or failure.
Examples
Example 1: Delete a category by ID without forcing deletion
Provide the mandatory 'Category ID' and keep 'Force Delete' as false or unset.
Example 2: Force delete a category even if transactions exist
Provide the 'Category ID' and set 'Force Delete' to true.