FireFly III icon

FireFly III

Read, update, write and delete data using the powerful FireFly III API

Actions89

Transactions API → Update Transaction

AI-generated

Overview

This node operation updates an existing transaction in the FireFly III system using the Transactions API. It allows users to modify various details of a transaction, including type, date, amount, description, currency, accounts involved, tags, notes, and references. This operation is useful for maintaining accurate and up-to-date financial records by editing transaction data as needed.

Use Case Examples

  1. Updating a withdrawal transaction to correct the amount and description.
  2. Modifying a transfer transaction to change the source and destination accounts.
  3. Adding tags and notes to an existing transaction for better categorization and tracking.

Properties

Name Meaning
X-Trace-ID A unique UUID identifier for the request, used for debugging and tracing.
Transaction ID The ID of the transaction to update.
Transactions Call Settings Settings that control the behavior of the transaction update call, such as error handling for duplicate hashes, rule application, webhook triggering, and group title for split transactions.
Transaction(s) The details of the transaction(s) to update, including fields like transaction journal ID, type, date, amount, description, currency, accounts, tags, notes, and references.

Output

JSON

  • json - The JSON response from the FireFly III API containing the updated transaction data.

Dependencies

  • Requires an API key credential for FireFly III OAuth2 authentication to access the FireFly III API.

Troubleshooting

  • Ensure the Transaction ID is provided and valid; missing or incorrect IDs will cause errors.
  • Verify that the transaction fields are correctly formatted, especially date and amount fields.
  • Check for duplicate transaction hashes if 'Error If Duplicate Hash' is enabled, as this will cause the update to fail.
  • Make sure the API credentials are correctly configured and have the necessary permissions to update transactions.

Links

Discussion