Vikunja icon

Vikunja

Get data from Vikunja's API

Overview

This node integrates with the Vikunja API to manage tasks, specifically allowing you to add a label to a task. It is useful in scenarios where you want to organize or categorize tasks dynamically by assigning labels programmatically. For example, you might use this node to tag tasks as "urgent" or "in progress" based on external triggers or workflow conditions.

Properties

Name Meaning
Task ID The unique identifier of the task to which you want to add a label.
Label Title or ID The label to add to the task. You can select a label from a searchable list or specify its ID directly.

Output

The node outputs JSON data representing the result of the label addition operation. This typically includes confirmation that the label was added and may contain details about the updated task or label association. The output does not include binary data.

Dependencies

  • Requires an API key credential for authenticating with the Vikunja API.
  • Needs the base URL of the Vikunja instance configured in the node credentials.
  • Uses the Vikunja REST API endpoints for tasks and labels.

Troubleshooting

  • Common issues:

    • Invalid or missing Task ID or Label ID will cause the operation to fail.
    • Network connectivity problems or incorrect API URL configuration can prevent successful API calls.
    • Insufficient permissions on the API key may lead to authorization errors.
  • Error messages:

    • "Task not found" — Verify the Task ID is correct and exists.
    • "Label not found" — Ensure the label ID or selected label exists.
    • "Unauthorized" — Check that the API key is valid and has necessary permissions.
    • "Network error" — Confirm the API URL is reachable and correctly set.

Links and References

Discussion