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 retrieve data related to projects, tasks, labels, teams, and webhooks. Specifically, for the "Project" resource and the "Get All Link Shares" operation, it fetches all link shares associated with a specified project. This is useful in scenarios where users want to manage or audit shared links for collaboration or security purposes.
Practical examples include:
- Listing all public or private shareable links of a project to review access.
- Automating reports on shared project resources.
- Integrating with other systems to synchronize or monitor shared links.
Properties
| Name | Meaning |
|---|---|
| Project Title or ID | The project to operate on. You can select a project from a searchable list or specify its ID directly. This identifies which project's link shares will be retrieved. |
Output
The node outputs JSON data containing the list of all link shares for the specified project. Each item in the output typically includes details about the link share such as URL, permissions, expiration, and possibly metadata about who created the share.
If the node supports binary data output (not indicated here), it would represent downloadable content or attachments related to the link shares, but this is not evident from the provided code.
Dependencies
- Requires an API key credential for authenticating with the Vikunja API.
- Needs the base URL of the Vikunja instance configured in the credentials.
- Uses the
/projects/{projectId}/linksharesendpoint (implied by operation name) to fetch link shares. - The node depends on internal helper functions for searching projects and mapping results.
Troubleshooting
Common issues:
- Invalid or missing project ID: Ensure the project exists and the ID or selection is correct.
- Authentication errors: Verify that the API key credential is valid and has sufficient permissions.
- Network or API endpoint errors: Confirm the Vikunja API URL is reachable and correctly set.
Error messages:
- "Project not found": Check the project identifier.
- "Unauthorized": Recheck API credentials.
- "Failed to fetch link shares": Could indicate network issues or incorrect endpoint usage.
Resolving these usually involves verifying input parameters, credentials, and network connectivity.
Links and References
- Vikunja API Documentation
- Vikunja Official Website
- n8n Documentation on Creating Custom Nodes