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 create new projects within a user's task management environment. It allows users to specify project details such as title, parent project, description, and visual attributes like color. This is useful for organizing tasks into hierarchical projects, managing project metadata, and setting project preferences like favorites or archived status.
Practical examples include:
- Creating a new project under an existing parent project to maintain a structured task hierarchy.
- Setting a project as favorite for quick access.
- Assigning a unique identifier to a project for easier reference in task identifiers.
- Adding descriptive information and color coding to projects for better visual organization.
Properties
| Name | Meaning |
|---|---|
| Parent Project Title or ID | The parent project under which the new project will be created. Can be selected from a list or specified by ID. |
| Project Title | The name/title of the new project. This is a required field. |
| Archived | Whether the project should be marked as archived (true/false). |
| Description | A textual description providing more details about the project. |
| Favorite | Whether the project should be marked as a favorite (true/false). |
| Identifier | A unique short identifier for the project, used to build task identifiers. |
| Project Color | The color assigned to the project, represented as a hex color code (e.g., #000000). |
Output
The node outputs JSON data representing the newly created project as returned by the Vikunja API. This typically includes all project properties such as its ID, title, description, parent project ID, archived status, favorite status, identifier, and color.
If the node supports binary data output, it would relate to any file attachments or media associated with the project, but based on the provided code and properties, this node primarily deals with JSON data.
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.
- Relies on the Vikunja REST API endpoints for project creation and searching existing projects.
Troubleshooting
Common Issues:
- Invalid or missing API credentials can cause authentication failures.
- Providing an invalid parent project ID may result in errors or failure to create the project.
- Missing required fields such as "Project Title" will prevent successful creation.
Error Messages:
- Authentication errors usually indicate incorrect or expired API keys; verify and update credentials.
- Validation errors from the API may indicate missing or malformed input properties; ensure all required fields are correctly filled.
- Network or connectivity issues might cause timeouts or unreachable host errors; check network settings and API URL correctness.
Links and References
- Vikunja Official Website
- Vikunja API Documentation (for detailed API endpoint info)
- n8n Documentation on Creating Custom Nodes