Vikunja

Overview

This node integrates with the Vikunja API to manage various resources, including Teams. Specifically, the "Delete" operation for the Team resource allows users to remove a team from their Vikunja workspace by specifying the team either by its name (selected from a list) or directly by its ID. This is useful in scenarios where teams are no longer needed or were created by mistake and need to be cleaned up.

Practical examples:

• Automatically deleting a team after a project completion.
• Removing test or temporary teams created during development or onboarding.
• Cleaning up orphaned teams that no longer have active members.

Properties

The property supports two modes:

• From List: Search and select a team by name.
• ID: Provide the unique identifier of the team as a string.

Output

The node outputs JSON data representing the result of the delete operation. Typically, this will include confirmation of deletion or any relevant status message returned by the Vikunja API. There is no binary output associated with this operation.

Dependencies

• Requires an API key credential for authenticating with the Vikunja API.
• The base URL for the Vikunja API must be configured in the node credentials.
• The node depends on the Vikunja REST API being accessible and the user having sufficient permissions to delete teams.

Troubleshooting

• Common issues:

  • Providing an invalid or non-existent team ID will result in an error from the API.
  • Insufficient permissions to delete a team may cause authorization errors.
  • Network connectivity problems can prevent the node from reaching the Vikunja API.

• Error messages and resolutions:

  • "Team not found": Verify the team ID or select the correct team from the list.
  • "Unauthorized" or "Forbidden": Check that the API key has the necessary permissions.
  • Timeout or network errors: Ensure the API URL is correct and the server is reachable.

Links and References

• Vikunja API Documentation
• Vikunja Official Website