Kan Task

Interact with Kanboard tasks

Overview

This node interacts with Kanboard tasks, allowing users to create, get, update, delete, or list tasks within Kanboard projects. It is useful for automating task management workflows, such as creating new tasks with specific details, retrieving task information, updating task attributes, deleting tasks, or listing all tasks optionally filtered by project ID.

Use Case Examples

  1. Create a new task in a specific project with a title and due date.
  2. Retrieve details of a specific task by its ID.
  3. Update the description or owner of an existing task.
  4. Delete a task by its ID to clean up completed or obsolete tasks. "List All" operation to fetch all tasks optionally filtered by project ID.

Properties

Name Meaning
Project ID The ID of the project to filter tasks for listing or to assign a new task to (required for create, optional for list).

Output

JSON

  • id - The unique identifier of the task.
  • title - The title of the task.
  • project_id - The ID of the project the task belongs to.
  • description - The description of the task.
  • column_id - The ID of the column where the task is placed.
  • owner_id - The ID of the user assigned to the task.
  • due_date - The due date of the task in ISO 8601 format.
  • position - The position of the task within its column.
  • success - Indicates successful deletion of a task (only for delete operation).

Dependencies

  • Requires an API key credential for Kanboard API access.

Troubleshooting

  • Common issues include invalid or missing API credentials, resulting in authentication errors.
  • Incorrect or missing task or project IDs can cause the node to fail or return empty results.
  • Date fields must be in valid ISO 8601 format; otherwise, the API may reject the request.
    Error messages from the node will indicate the operation that failed and the reason, such as 'Kan Task operation failed: '.
  • Ensure the Kanboard API URL is correctly configured in the credentials without trailing slashes.

Links

Discussion