Vikunja

Overview

The node integrates with the Vikunja API to update an existing label resource. It allows users to modify a label's title, description, and color by specifying the label either through selection from a list or by providing its ID directly. This is useful in task and project management workflows where labels categorize or prioritize items, enabling dynamic updates to labeling schemes without manual intervention.

Practical examples include:

• Automatically updating label colors based on project status changes.
• Renaming labels to reflect evolving terminology or priorities.
• Adding or modifying descriptions to provide more context for team members.

Properties

Output

The node outputs JSON data representing the updated label object returned by the Vikunja API. This typically includes fields such as the label's ID, title, description, color, and possibly metadata like creation or modification timestamps.

No binary data output is involved.

Dependencies

• Requires an API key credential for authenticating requests to the Vikunja API.
• The base URL of the Vikunja instance must be configured in the node credentials.
• Network access to the Vikunja server is necessary.

Troubleshooting

• Invalid Label ID: If the provided label ID does not exist, the API will return an error. Verify the label exists or select it from the list mode.
• Authentication Errors: Ensure the API key credential is valid and has sufficient permissions to update labels.
• Invalid Color Format: The label color must be a valid hex color string; otherwise, the API may reject the request.
• Missing Required Fields: Both the label identifier and the new title are required; omitting these will cause errors.

Links and References

• Vikunja API Documentation
• Vikunja GitHub Repository