Vikunja icon

Vikunja

Get data from Vikunja's API

Overview

This 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 tasks, 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 team terminology.
  • Adding or modifying descriptions to clarify label purposes.

Properties

Name Meaning
Label Title or ID The target label to update. Can be selected from a searchable list of existing labels or specified by its unique ID.
Label Title The new title/name for the label.
Description A textual description providing more details about the label.
Label Color The color assigned to the label, represented as a hex color code (e.g., #FF0000 for red).

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, updated title, description, color, and possibly metadata like timestamps or user information. There is no binary output.

Dependencies

  • Requires an API key credential for authenticating requests to the Vikunja API.
  • Needs the base URL of the Vikunja instance configured in the node credentials.
  • Relies on the Vikunja REST API being accessible and operational.

Troubleshooting

  • Invalid Label ID: If the provided label ID does not exist, the API will return an error. Verify the label ID or select from the list to avoid typos.
  • Authentication Errors: Ensure the API key credential is valid and has sufficient permissions to update labels.
  • Network Issues: Confirm that the Vikunja server URL is correct and reachable from n8n.
  • Missing Required Fields: The label title is mandatory; omitting it will cause validation errors.
  • Color Format: The label color must be a valid hex color string; invalid formats may be rejected.

Links and References

Discussion