Vikunja icon

Vikunja

Get data from Vikunja's API

Project → Create a Link Share

AI-generated

Overview

This node operation creates a link share for a specified project in Vikunja. It allows users to share project access via a link with configurable permissions and optional settings such as link name, password protection, and sharing type. This is useful for securely sharing project data with external collaborators or team members without requiring direct user accounts.

Use Case Examples

  1. Create a read-only link share for a project to allow external stakeholders to view project details.
  2. Create a password-protected link share with admin permissions for trusted collaborators to manage the project.

Properties

Name Meaning
Project Title or ID The project to operate on, selectable from a list or by specifying its ID.
Permission The level of access granted by the link share, such as Read Only, Read & Write, or Admin.
Additional Fields Optional settings for the link share including name, password, and sharing type.

Output

JSON

  • id - The unique identifier of the created link share.
  • url - The URL of the created link share for accessing the project.
  • permission - The permission level assigned to the link share.
  • name - The name assigned to the link share, if any.
  • sharing_type - The type of sharing, indicating if password protection is enabled.

Dependencies

  • An API key credential for authenticating with the Vikunja API.

Troubleshooting

  • Ensure the project ID or title is correctly specified and exists in Vikunja to avoid 'project not found' errors.
  • Verify that the API credentials are valid and have sufficient permissions to create link shares.
  • If setting a password, ensure it meets any password policy requirements of Vikunja.
  • Check network connectivity and proxy settings if requests time out or fail to reach the Vikunja server.

Links

  • Vikunja API Documentation - Official API documentation for Vikunja, useful for understanding link share creation and permissions.

Discussion