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 teams within the Vikunja task management system. Specifically, the "Update" operation for the "Team" resource allows users to modify existing team details such as the team's name and description. This is useful in scenarios where team information needs to be kept current, for example, when a team changes its focus or requires updated descriptive information.
Practical examples include:
- Renaming a team to reflect a new project or department.
- Adding or updating a description to clarify the team's purpose or membership.
Properties
| Name | Meaning |
|---|---|
| Team Name or ID | Select the team to update either by choosing from a searchable list of existing teams or by specifying the team's unique ID directly. |
| Team Name | The new name to assign to the team. This is a required field when updating a team. |
| Description | A textual description for the team, providing additional context or details about the team. |
Output
The node outputs JSON data representing the updated team object as returned by the Vikunja API. This typically includes fields such as the team's ID, name, description, and possibly other metadata related to the team. There is no binary output associated with this operation.
Dependencies
- Requires an active connection to the Vikunja API via an API key credential.
- The base URL for the Vikunja API must be configured in the node credentials.
- The node uses HTTP requests with JSON payloads to communicate with the Vikunja server.
Troubleshooting
- Invalid Team ID or Name: If the specified team does not exist or the ID is incorrect, the API will return an error. Verify the team identifier by using the list mode or searching for the correct team.
- Missing Required Fields: The "Team Name" property is mandatory for updates. Omitting it will cause the request to fail.
- API Connection Issues: Ensure that the API URL and authentication credentials are correctly set up. Network issues or incorrect credentials will prevent successful communication.
- Permission Errors: The API user must have sufficient permissions to update team information; otherwise, the request will be denied.
Links and References
- Vikunja API Documentation – Official API reference for managing teams and other resources.
- n8n Documentation – General guidance on configuring API credentials and using custom nodes.