mercury_update_transaction
Update a transaction's internal note or category for bookkeeping and attaching memos. No money movement. Send null to clear a field, omit to keep current value.
Instructions
Update a transaction's internal note or category (no money movement).
USE WHEN: tagging a transaction with a category for bookkeeping, or attaching an internal memo. Send null to clear a field, omit the key to keep the current value.
DO NOT USE: to change the amount, counterparty, or status — those are immutable post-execution. Mercury endpoint is PATCH /transaction/{id} (no accountId in the path).
SIDE EFFECTS: overwrites the note / category on Mercury's side. Persistent. Audit log on Mercury records the change. No effect on the booked transaction itself or on the counterparty.
RETURNS: { id, note, categoryId, ... } — the updated transaction.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| transactionId | Yes | The transaction ID | |
| note | No | Internal note (send null to clear, omit to keep current) | |
| categoryId | No | Category ID (UUID, see mercury_list_categories). Send null to clear, omit to keep current. |