Vikunja icon

Vikunja

Get data from Vikunja's API

Overview

This node integrates with the Vikunja API to update an existing Project View within a specified project. It allows users to modify attributes such as the title, view kind (e.g., list, gantt, table, kanban), bucket configuration mode, and additional optional settings like default and done bucket IDs or filters applied to the view.

Typical use cases include:

  • Renaming or reconfiguring a project view to better organize tasks.
  • Changing how tasks are visually represented (switching between list, gantt, table, or kanban views).
  • Adjusting bucket behaviors for task management within the project view.

For example, a project manager might update a Kanban view's title and set a new default bucket where unassigned tasks are placed, improving workflow clarity.

Properties

Name Meaning
Project Title or ID The target project to operate on; can be selected from a searchable list or specified by its ID.
Project View ID The specific project view to update; selectable from a list of views within the chosen project or by ID.
Project View Title The new title for the project view.
View Kind The type of view to display: List, Gantt, Table, or Kanban.
Bucket Configuration Mode How buckets are configured in the view: None, Manual, or Filter.
Additional Fields (Options): Collection of optional settings:
- Default Bucket ID ID of the bucket where new tasks without a bucket are added (default is leftmost bucket).
- Done Bucket ID ID of the bucket marking tasks as done; tasks moved here are considered completed.
- Project View Filter A filter string to apply to the project view to limit visible tasks.

Output

The node outputs JSON data representing the updated project view object returned by the Vikunja API. This typically includes the updated properties of the project view such as its ID, title, kind, bucket configuration, and any filters applied.

No binary data output is involved.

Dependencies

  • Requires an API key credential for authenticating requests to the Vikunja API.
  • Needs the base URL of the Vikunja instance configured in the node credentials.
  • Uses internal helper methods to search projects and project views for selection lists.

Troubleshooting

  • Invalid Project or View ID: If the provided project or project view ID does not exist or is incorrect, the API will return an error. Verify IDs by using the search options or checking the Vikunja interface.
  • Authentication Errors: Ensure the API key credential is valid and has sufficient permissions to update project views.
  • Missing Required Fields: The "Project View Title" and "View Kind" are required; omitting them will cause validation errors.
  • API Connectivity Issues: Confirm that the base URL is correct and accessible from n8n, and that there are no network restrictions blocking access.

Links and References

Discussion