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 a link share for a specified project. A link share allows users to share access to a project with others via a generated link, optionally protected by a password and assigned specific access rights. This is useful in scenarios where you want to collaborate or share project data externally without adding users directly to the project.
Practical examples:
- Sharing a project with external stakeholders who only need read-only access.
- Allowing team members to edit a project via a shared link with write permissions.
- Creating an admin-level link share for trusted collaborators to manage the project.
Properties
| Name | Meaning |
|---|---|
| Project Title or ID | The target project to create the link share for. Can be selected from a searchable list of projects or specified by its ID. |
| Right | The permission level granted by the link share: Read Only, Read & Write, or Admin. |
| Additional Fields | Optional settings for the link share: |
| - Name | A custom name for the link share; actions performed via this link will be attributed to this name. |
| - Password | An optional password to protect the link share. It can only be set during creation and not retrieved later. |
| - Sharing Type | Whether the link share requires a password ("With Password") or not ("Without Password"). |
Output
The node outputs JSON data representing the created link share object returned by the Vikunja API. This typically includes details such as the link share ID, URL, associated project, permissions, and metadata like the name and sharing type. No binary data output is involved.
Dependencies
- Requires an API key credential for authenticating with the Vikunja API.
- The base URL of the Vikunja instance must be configured in the node credentials.
- Network access to the Vikunja server is necessary.
Troubleshooting
- Invalid Project ID or Not Found: If the specified project does not exist or the ID is incorrect, the API will return an error. Verify the project selection or ID.
- Insufficient Permissions: The API user must have rights to create link shares on the project. Ensure the API key has adequate permissions.
- Password Setting Issues: Passwords can only be set at creation time. Attempting to retrieve or update the password later will fail.
- API Connectivity Errors: Check network connectivity and correct API URL configuration if requests fail.
- Invalid Option Values: Ensure that the "Right" and "Sharing Type" values are within the allowed options.