Vikunja icon

Vikunja

Get data from Vikunja's API

Overview

This node integrates with the Vikunja API to retrieve information about a specific label. It is designed to fetch details of a label by either selecting it from a list or specifying its unique ID. This functionality is useful in task and project management workflows where labels categorize or tag tasks, enabling automation processes that depend on label metadata.

Practical examples include:

  • Automatically fetching label details to update task properties based on label attributes.
  • Using label information to trigger conditional logic in workflows depending on label characteristics.
  • Synchronizing label data between Vikunja and other systems.

Properties

Name Meaning
Label Title or ID The label to operate on. You can select a label from a searchable list or specify its ID directly.

The "Label Title or ID" property supports two modes:

  • From List: Choose a label from a dynamically searchable list of existing labels.
  • ID: Provide the unique identifier of the label manually.

Output

The node outputs JSON data representing the label's details as returned by the Vikunja API. This typically includes fields such as the label's ID, title, color, and any other metadata associated with the label in Vikunja.

No binary data output is involved.

Dependencies

  • Requires an active connection to the Vikunja API via an API key credential.
  • The node expects the base URL of the Vikunja instance to be configured in the credentials.
  • Network access to the Vikunja server must be available for API calls.

Troubleshooting

  • Invalid Label ID: If the specified label ID does not exist, the node will likely return an error indicating the label was not found. Verify the ID or use the list mode to select a valid label.
  • Authentication Errors: Ensure the API key credential is correctly set up and has sufficient permissions to read label data.
  • Network Issues: Connection failures may occur if the Vikunja server URL is incorrect or unreachable. Confirm the base URL and network connectivity.
  • Empty Results in List Mode: If no labels appear in the selection list, check that there are labels created in Vikunja and that the API user has access to them.

Links and References

Discussion