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
- Team Actions
- Task Actions
- Webhook Actions
Overview
This node integrates with the Vikunja API to create a new label resource. Labels in Vikunja are used to categorize or tag tasks and projects, helping users organize their work more effectively. This node is beneficial when automating task management workflows, such as dynamically generating labels based on project status, priority, or other criteria.
Practical examples include:
- Automatically creating color-coded labels for different task priorities.
- Adding descriptive labels to tasks imported from other systems.
- Generating labels to mark tasks belonging to specific teams or projects.
Properties
| Name | Meaning |
|---|---|
| Label Title | The title or name of the label to be created. |
| Description | A textual description providing additional details about the label. |
| Label Color | The color of the label represented as a hex color code (e.g., #000000 for black). |
Output
The node outputs JSON data representing the newly created label object as returned by the Vikunja API. This typically includes fields such as the label's unique identifier, title, description, color, and any metadata provided by the API.
If the node supports binary data output, it would generally relate to attachments or images associated with the label, but this node focuses on JSON data only.
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.
- The node sends HTTP requests with JSON payloads to the Vikunja REST API endpoints.
Troubleshooting
- Authentication errors: Ensure that the API key credential is valid and has sufficient permissions to create labels.
- Invalid color format: The label color must be a valid hex color string; otherwise, the API may reject the request.
- Missing required fields: The "Label Title" is mandatory; omitting it will cause the API to return an error.
- API endpoint issues: Verify the base URL is correct and accessible from the n8n environment.
Links and References
- Vikunja API Documentation – Official API reference for understanding label creation and related endpoints.
- Hex Color Codes – Guide to valid hex color formats.