FireFly III icon

FireFly III

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

Actions45

Overview

The "Update Tag" operation in the Tags API allows users to modify an existing tag's details within the FireFly III system. This node is useful when you want to rename a tag or update its optional metadata such as date and description. For example, if you have a tag used for categorizing expenses and want to correct a typo in its name or add a descriptive note, this operation enables that update via the API.

Common scenarios include:

  • Renaming tags to maintain consistent naming conventions.
  • Adding or updating descriptions to provide more context about the tag.
  • Setting or changing the date associated with a tag for organizational purposes.

Properties

Name Meaning
X-Trace-ID A unique UUID identifier for the request, used for debugging and tracing (e.g., 123e4567-e89b-12d3-a456-426614174000).
Target Tag Name/ID The current name or ID of the tag to be updated; used in the API path. Note: Using names with non-ASCII characters may cause issues.
New Tag Name The new name to assign to the tag.
Extra Tag Options Additional optional fields for the tag:
• Tag Date: Optional date in YYYY-MM-DD format.
• Tag Description: Optional descriptive text for the tag.

Output

The output JSON contains the updated tag object as returned by the FireFly III API after a successful update. This typically includes the tag's ID, new name, date, description, and other metadata fields managed by the system.

No binary data is produced by this operation.

Dependencies

  • Requires an active connection to the FireFly III API with appropriate authentication credentials (such as an OAuth2 token or API key).
  • The node expects the FireFly III instance URL and credentials to be configured in n8n.
  • The user must have permission to update tags in the FireFly III system.

Troubleshooting

  • Issue: Using a tag name with international (non-ASCII) characters as the target identifier may lead to unexpected errors or failures.

    • Resolution: Prefer using the tag's unique ID instead of its name when specifying the target tag.

  • Issue: Missing required parameters like the target tag identifier or new tag name.

    • Resolution: Ensure both "Target Tag Name/ID" and "New Tag Name" are provided before executing the node.

  • Issue: Authentication errors or permission denied responses from the API.

    • Resolution: Verify that the API credentials are valid and have sufficient permissions to update tags.

  • Issue: Network or connectivity problems causing request failures.

    • Resolution: Check network access to the FireFly III API endpoint and retry the operation.

Links and References

Discussion