Actions89
- General Actions
- About API Actions
- Accounts API Actions
- Available Budgets API Actions
- Bills API Actions
- Budgets API Actions
- Transactions API Actions
- Categories API Actions
- Tags API Actions
- Rules & Groups API Actions
- Piggy Banks API Actions
- Object Groups API Actions
- Recurrences API Actions
Tags API → Update Tag
AI-generatedOverview
This node operation updates an existing tag in the FireFly III system using the FireFly III API. It allows users to modify the name and optional additional properties of a tag identified by its name or ID. This is useful for managing and organizing tags dynamically in financial data workflows, such as renaming tags or updating their descriptions and dates.
Use Case Examples
- Renaming a tag from 'Groceries' to 'Supermarket' to better reflect spending categories.
- Adding or updating a description or date for a tag to provide more context in financial reports.
Properties
| Name | Meaning |
|---|---|
| X-Trace-ID | A unique UUID identifier for the request, used for debugging and tracing. |
| Target Tag Name/ID | The identifier (name or ID) of the tag to update, used in the API path. |
| New Tag Name | The new name to assign to the tag, used in the API request body. |
| Extra Tag Options | Optional additional properties for the tag, such as date and description. |
Output
JSON
json- The JSON response from the FireFly III API representing the updated tag object.
Dependencies
- FireFly III API with OAuth2 authentication
Troubleshooting
- Ensure the 'Target Tag Name/ID' is correct and exists in the FireFly III system to avoid 404 errors.
- Verify that the 'New Tag Name' is provided and valid to prevent validation errors from the API.
- Check the format of the 'Tag Date' if provided; it must be in YYYY-MM-DD format.
- Use the 'X-Trace-ID' for tracing and debugging request issues if the API returns errors.
Links
- FireFly III API Documentation - Update Tag - Official API documentation for updating a tag in FireFly III.