Actions57
- Label Actions
- Project Actions
- Add a Team
- Add a User
- Create
- Create a Kanban Bucket
- Create a Link Share
- Create a Project View
- Delete
- Delete a Kanban Bucket
- Delete a Link Share
- Delete a Project View
- Duplicate
- Get
- Get All Link Shares
- Get All Project Views
- Get All Teams
- Get All Users
- Remove a Team From a Project
- Remove a User From a Project
- Update
- Update a Kanban Bucket
- Update a Project View
- Update a Team's Rights on a Project
- Update a User's Rights on a Project
- Task Actions
- Team Actions
- Webhook Actions
Overview
This node integrates with the Vikunja API to manage labels within the task management system. Specifically, the "Label - Create" operation allows users to create new labels by specifying a title, description, and color. This is useful for organizing tasks visually and categorically in Vikunja.
Common scenarios include:
- Automatically generating labels based on project needs or external triggers.
- Creating standardized labels for task categorization during workflow automation.
- Enhancing task filtering and reporting by adding descriptive labels programmatically.
Example: A user can automate the creation of a "High Priority" label with a red color and a description explaining its use, ensuring consistent labeling across projects.
Properties
| Name | Meaning |
|---|---|
| Label Title | The name/title of the label to be created. This is a required field. |
| Description | An optional text describing the purpose or details of the label. |
| Label Color | The color of the label represented as a hex color code (e.g., #FF0000 for red). |
Output
The node outputs JSON data representing the newly created label object returned from the Vikunja API. This typically includes fields such as the label's unique identifier, title, description, color, and possibly metadata like creation timestamps.
If the node supports binary data output, it would relate to any file or media associated with the label, but based on the provided code and properties, this node focuses solely on JSON data output.
Dependencies
- Requires an active connection to the Vikunja API via an API URL and an API authentication token configured in n8n credentials.
- The base URL for API requests is derived from the user's credential configuration.
- The node sends requests with JSON content type headers.
Troubleshooting
- Missing Required Fields: If "Label Title" is not provided, the node will likely throw a validation error. Ensure all required fields are filled.
- Authentication Errors: Incorrect or missing API credentials will cause authorization failures. Verify that the API key/token and base URL are correctly set in the credentials.
- API Endpoint Issues: If the base URL is incorrect or the Vikunja server is unreachable, the node will fail to connect. Confirm network connectivity and endpoint correctness.
- Invalid Color Format: Providing an invalid hex color string may result in API rejection. Use standard hex color codes (e.g., #123ABC).
Links and References
- Vikunja Official Website
- Vikunja API Documentation
- n8n Documentation on HTTP Request Nodes (for understanding API integrations)