Vikunja

Overview

This node integrates with the Vikunja API to manage teams within the Vikunja task management system. Specifically, the "Delete" operation under the "Team" resource allows users to delete a team by specifying its name or ID. This is useful for automating cleanup of unused or obsolete teams in Vikunja, ensuring that your workspace remains organized.

Practical examples include:

• Automatically removing project teams that are no longer active.
• Cleaning up test or temporary teams created during workflows.
• Managing team lifecycle as part of broader automation around user and project management.

Properties

The property supports two modes:

• From List: Select a team interactively from a searchable dropdown.
• 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 be a confirmation of deletion or an empty response indicating success. No binary data output is involved.

Dependencies

• Requires an API key credential for authenticating with the Vikunja API.
• The node expects the base URL of the Vikunja instance to be configured in the credentials.
• Network access to the Vikunja API endpoint is necessary.

Troubleshooting

• Common issues:

  • Providing an invalid or non-existent team ID will cause the operation to fail.
  • Insufficient permissions on the API key may prevent deletion.
  • Network connectivity problems can cause timeouts or unreachable errors.

• Error messages:

  • "Team not found": Verify the team ID or selection is correct.
  • "Unauthorized" or "Forbidden": Check that the API key has sufficient rights to delete teams.
  • "Network Error": Ensure the API URL is reachable and correctly configured.

Resolving these typically involves verifying input values, checking API credentials, and confirming network settings.

Links and References

• Vikunja API Documentation
• Vikunja Official Website