Edit or pause a fixed cost
recurring_updateEdit a fixed-cost template or pause and resume its recurring bookings by sending only the fields to change. Use it for updates and pausing; resuming skips missed cycles.
Instructions
Change a fixed-cost template or pause and resume it (paused). Send only the fields to change; at least one is required (400 invalid_body otherwise). Use it for edits and pausing; to skip one cycle use recurring_advance, to remove the template for good use recurring_delete. Only the creator of the template or a flat admin may call it, others get 403 not_owner. Resuming does not book the missed cycles: the due date jumps to the next cycle day from today. Changing amountCents, paidByMemberId or splits is checked like recurring_create (403 paid_by_must_include_caller, 400 splits_sum_mismatch). Pass expectedNextDueAt to guard against concurrent edits or bookings: if the template moved meanwhile, the call fails with 409 recurring_expense_changed and nothing is written; read it again with recurring_get and decide. Returns the updated template as recurringExpense.
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": {
"id": "<id>"
},
"name": "recurring_update"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Id of the fixed-cost template, as returned in recurringExpenses[].id by recurring_list or in recurringExpense.id by recurring_create. | |
| paused | No | true pauses the template (no automatic bookings), false resumes it. Omit to leave the pause state as it is. | |
| splits | No | Who owes what per charge, one entry per member. Amounts must add up to amountCents. Member ids come from members_list. Replaces the whole list. | |
| wgCode | No | Share code of the flat (code from wg_list). Leave it out when the account belongs to one flat. | |
| category | No | New category for booked expenses. | |
| currency | No | Fixed-cost templates are always in EUR, which is the only accepted value (the app rejects others with recurring_currency_unsupported). Omit it. | |
| nextDueAt | No | Move the next due date, ISO 8601 with offset. Must lie within 366 days in the past and 10 years ahead. Sending the unchanged value is harmless. | |
| amountCents | No | New amount per charge in cents of EUR. If you change it, also send splits that add up to it unless the current splits already do. | |
| description | No | New label for the template. | |
| intervalMonths | No | New number of months between charges, for example 1 monthly or 12 yearly. | |
| paidByMemberId | No | New paying member, from members_list. | |
| expectedNextDueAt | No | nextDueAt of the template as you last read it from recurring_get or recurring_list (ISO 8601 with offset). Used as a concurrency guard. |