Vikunja

Overview

This node integrates with the Vikunja API to manage labels within the task management system. Specifically, the "Delete" operation for the "Label" resource allows users to remove a label by specifying its title or ID. This is useful in scenarios where labels are no longer needed or were created by mistake, helping keep the project organized and clean.

Practical examples include:

• Automatically deleting obsolete or temporary labels after a project phase ends.
• Cleaning up labels that were imported incorrectly from another system.
• Removing labels as part of a workflow that archives completed tasks and their metadata.

Properties

The property supports two modes:

• From List: Choose a label from a dynamically searched list of existing labels.
• ID: Provide the exact ID of the label to delete.

Output

The node outputs JSON data representing the result of the delete operation. Typically, this will be a confirmation of successful deletion or an error message if the label could not be deleted. There is no binary output associated with this operation.

Example output structure might look like:

{
  "success": true,
  "message": "Label deleted successfully"
}

or in case of failure:

{
  "success": false,
  "error": "Label not found"
}

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.

Troubleshooting

• Label Not Found: If the label ID or name does not exist, the node will return an error. Verify the label exists before attempting deletion.
• Authentication Errors: Ensure the API key credential is valid and has sufficient permissions to delete labels.
• Network Issues: Check connectivity to the Vikunja API endpoint; timeouts or unreachable errors indicate network problems.
• Invalid Input: Providing an empty or malformed label ID will cause the operation to fail. Always provide a valid label identifier.

Links and References

• Vikunja API Documentation
• Vikunja Official Website