Actions45
- General Actions
- About API Actions
- Accounts API Actions
- Transactions API Actions
- Categories API Actions
- Tags API Actions
- Rules & Groups API Actions
Overview
The "Delete Transaction" operation in the Transactions API resource allows users to remove a specific financial transaction from their FireFly III account by providing its unique transaction ID. This node is useful for automating the cleanup or correction of transaction records, such as deleting erroneous entries or removing outdated transactions.
Practical examples include:
- Automatically deleting transactions that were imported incorrectly.
- Removing test transactions created during development or testing phases.
- Cleaning up duplicate transactions detected by other automation workflows.
Properties
| Name | Meaning |
|---|---|
| X-Trace-ID | A unique UUID identifier for the request, used for debugging and tracing (optional). |
| Transaction ID | The unique identifier of the transaction to delete. This property is required. |
Output
The output JSON contains the response from the FireFly III API after attempting to delete the specified transaction. Typically, this will be an object indicating success or failure of the deletion operation. The exact structure depends on the API's response but generally includes status information confirming whether the transaction was deleted.
No binary data output is produced by this operation.
Dependencies
- Requires an active connection to the FireFly III API with appropriate authentication credentials (e.g., an OAuth2 API key).
- The node uses the FireFly III API endpoint
/transactions/{transactionId}with the HTTP DELETE method. - No additional environment variables are explicitly required beyond standard API credential configuration.
Troubleshooting
Common Issues:
- Providing an invalid or non-existent Transaction ID will result in an error from the API indicating that the transaction could not be found.
- Missing or incorrect API credentials will cause authentication failures.
- Network connectivity issues can prevent the node from reaching the FireFly III API.
Error Messages:
- "Transaction not found": Verify that the Transaction ID is correct and exists in your FireFly III account.
- "Unauthorized" or "Authentication failed": Check that your API credentials are valid and have sufficient permissions.
- "Network error" or timeouts: Ensure your network connection is stable and the FireFly III API service is reachable.
Resolving these errors typically involves verifying input parameters, checking API credentials, and ensuring network connectivity.