Kan Task

Interact with Kanboard tasks
Join our community

Actions5

Overview

This node interacts with Kanboard tasks, allowing users to create, get, update, delete, and list tasks within a Kanboard project. 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 in a project.

Use Case Examples

  1. Create a new task in a Kanboard project with a title, description, due date, and assigned owner.
  2. Retrieve details of a specific task by its ID.
  3. Update the description or due date of an existing task.
  4. Delete a task by its ID from the Kanboard project.

Properties

Name Meaning
Project ID The ID of the project where the task belongs. Required for creating a task and optional for listing tasks.
Title The title of the task to be created. This is a required field for the create operation.
Additional Fields Optional additional fields for the task such as description, column ID, owner ID, due date, and position within the column.

Output

JSON

  • success - Indicates if the delete operation was successful (true) and returns the deleted task ID.
  • taskId - The ID of the task involved in the operation, especially for delete operation.
  • title - The title of the created or retrieved task.
  • project_id - The project ID associated with the task.
  • description - The description of the task if provided.
  • column_id - The column ID where the task is placed.
  • owner_id - The user ID assigned to the task.
  • due_date - The due date of the task in ISO 8601 format.
  • position - The position of the task in the column.

Dependencies

  • Requires an API key credential for Kanboard API access.

Troubleshooting

  • Common issues include providing invalid or missing project ID or task ID, which will cause API request failures.
  • Date fields must be in ISO 8601 format; otherwise, the API may reject the request.
  • Ensure the API URL is correctly configured without trailing slashes to avoid request errors.
  • Error messages from the node will indicate the operation failure and include the API error message for easier debugging.

Links

  • Kanboard API Documentation - Official API documentation for Kanboard, detailing endpoints and request formats for task management.

Discussion