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 and their users. Specifically, the "Remove a User From a Team" operation allows you to remove a specified user from a given team. This is useful in scenarios where team membership needs to be dynamically managed, such as automating user access control or cleaning up team assignments based on workflow conditions.
For example, if a user leaves a project or organization, this node can automatically remove them from all associated teams to maintain accurate team rosters.
Properties
| Name | Meaning |
|---|---|
| Team Name or ID | The target team to operate on. You can select a team from a searchable list or specify its ID directly. |
| User ID | The numeric identifier of the user to be removed from the selected team. |
Output
The node outputs JSON data representing the result of the removal operation. Typically, this will include confirmation that the user was successfully removed or an error message if the operation failed. The exact structure depends on the Vikunja API response but generally includes status information about the team-user relationship update.
No binary data output is involved in this operation.
Dependencies
- Requires an API key credential for authenticating with the Vikunja API.
- The node expects the base URL of the Vikunja instance to be configured in the credentials.
- Network connectivity to the Vikunja API endpoint is necessary.
Troubleshooting
Common Issues:
- Providing an invalid or non-existent Team ID or User ID will cause the operation to fail.
- Insufficient permissions for the API key may prevent user removal.
- Network issues or incorrect API URL configuration can lead to connection errors.
Error Messages:
- "User not found in team" — The specified user is not a member of the team; verify the User ID.
- "Team not found" — The provided team does not exist; check the Team ID or selection.
- Authentication errors — Ensure the API key credential is valid and has appropriate permissions.
Resolving these typically involves verifying input values, checking API credentials, and ensuring network access.