Vikunja icon

Vikunja

Get data from Vikunja's API

Overview

This node integrates with the Vikunja API to manage projects and related resources. Specifically, the Delete Project operation allows users to remove a project from their Vikunja workspace by specifying the project either via its title (selected from a list) or directly by its ID.

Common scenarios for this node include:

  • Automating cleanup of completed or obsolete projects.
  • Integrating project deletion into larger workflows where project lifecycle management is required.
  • Managing projects programmatically without manual intervention in the Vikunja UI.

Example use case: Automatically delete projects that have been marked as archived in another system by passing their IDs to this node.

Properties

Name Meaning
Project Title or ID The project to delete. Can be selected from a searchable list of existing projects or specified directly by its ID.

The property supports two modes:

  • From List: Search and select a project by its title.
  • ID: Provide the exact project ID as a string.

Output

The node outputs JSON data representing the result of the delete operation. Typically, this will confirm whether the deletion was successful or provide details if it failed.

No binary data output is expected from this operation.

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 project ID will cause the deletion to fail.
    • Insufficient permissions or incorrect API credentials can lead to authorization errors.
    • Network connectivity problems may prevent the node from reaching the Vikunja API.
  • Error messages:

    • "Project not found": Verify the project ID or selection is correct.
    • "Unauthorized" or "Authentication failed": Check that the API key credential is valid and has appropriate permissions.
    • Timeout or network errors: Ensure the Vikunja server is reachable and the base URL is correctly set.

Links and References

Discussion