> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Kanban Tool

> Kanban Tool is a visual project and task management platform for organizing boards, workflows, tasks, collaboration, and time tracking.

![Kanban Tool logo](https://mintcdn.com/composio-preview/tIuAovF9-7pXq2wA/images/toolkits/kanban_tool.svg?fit=max\&auto=format\&n=tIuAovF9-7pXq2wA\&q=85\&s=b9ffb90f52c3609816e1616ec20cd5c8)

* **Category:** project management
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 11
* **Triggers:** 0
* **Slug:** `KANBAN_TOOL`
* **Version:** 20261030\_00

## Tools

> [accordion] Add comment
>
> **Slug:** `KANBAN_TOOL_ADD_COMMENT`
>
> Add a text comment to a task.
>
> #### Input Parameters
>
> **content** `string` *required*
>
> Comment text.
>
> **task\_id** `integer` *required*
>
> Task receiving the comment.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Change task lifecycle
>
> **Slug:** `KANBAN_TOOL_CHANGE_TASK_LIFECYCLE`
>
> Archive, unarchive, soft-delete, or restore a task. Treat this as destructive because soft-delete hides the task from active workflows, although restore can reverse it.
>
> #### Input Parameters
>
> **action** `string ("archive" | "unarchive" | "delete" | "restore")` *required*
>
> Lifecycle transition to apply: archive, unarchive, delete (reversible soft-delete), or restore a soft-deleted task.
>
> **task\_id** `integer` *required*
>
> Task whose lifecycle state should change.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create subtask
>
> **Slug:** `KANBAN_TOOL_CREATE_SUBTASK`
>
> Create a subtask under an existing task or create it unattached for later use, with optional assignment and completion state.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Subtask name.
>
> **task\_id** `integer`
>
> Parent task ID. Omit to create an unattached subtask, then pass its ID to CREATE\_TASK.subtask\_ids when creating the parent task.
>
> **is\_completed** `boolean`
>
> Whether the subtask starts completed.
>
> **assigned\_user\_id** `integer`
>
> Optional assignee user ID.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create task
>
> **Slug:** `KANBAN_TOOL_CREATE_TASK`
>
> Create a task on a board with optional workflow placement, assignment, estimates, due dates, tags, external references, and previously created unattached subtasks.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Task name.
>
> **tags** `array`
>
> Task tags; sent upstream as comma-separated text.
>
> **board\_id** `integer` *required*
>
> Destination board ID.
>
> **due\_date** `string`
>
> Task due date in YYYY-MM-DD format.
>
> **position** `integer`
>
> Position within the selected stage and swimlane.
>
> **priority** `integer ("-1" | "0" | "1")`
>
> Priority: -1 low, 0 normal, or 1 high.
>
> **description** `string`
>
> Task description.
>
> **external\_id** `string`
>
> External-system identifier as an integer or string.
>
> **subtask\_ids** `array`
>
> IDs of unattached subtasks from CREATE\_SUBTASK to attach to the new task.
>
> **swimlane\_id** `integer`
>
> Initial swimlane ID from GET\_BOARD.
>
> **card\_type\_id** `integer`
>
> Card type ID from GET\_BOARD.
>
> **external\_link** `string`
>
> External-system URL.
>
> **size\_estimate** `number`
>
> Size estimate.
>
> **time\_estimate** `number`
>
> Time estimate in the account's configured units.
>
> **postponed\_until** `string`
>
> Date through which the task is postponed, in YYYY-MM-DD format.
>
> **assigned\_user\_id** `integer`
>
> Collaborator user ID to assign.
>
> **workflow\_stage\_id** `integer`
>
> Initial task-bearing leaf workflow stage ID from GET\_BOARD. Parent/group stage IDs may be normalized to a child stage by Kanban Tool.
>
> **recurring\_schedule** `string`
>
> Recurring-task schedule as an ISO 8601 next-run date-time immediately followed by a JSON schedule object. Requires the Recurring tasks power-up.
>
> **assert\_has\_unique\_external\_id** `boolean`
>
> Reject creation if external\_id is already used.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete subtask
>
> **Slug:** `KANBAN_TOOL_DELETE_SUBTASK`
>
> Soft-delete a subtask and return its tombstone.
>
> #### Input Parameters
>
> **subtask\_id** `integer` *required*
>
> Subtask to soft-delete.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get board
>
> **Slug:** `KANBAN_TOOL_GET_BOARD`
>
> Fetch a board's workflow configuration and collaborators without loading its full active task collection.
>
> #### Input Parameters
>
> **board\_id** `integer` *required*
>
> Board ID returned by LIST\_BOARDS or a task.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get task
>
> **Slug:** `KANBAN_TOOL_GET_TASK`
>
> Fetch a task with its comments, subtasks, attachments, changelog, dependencies, and time trackers. A deleted task is returned as a tombstone with deleted\_at set.
>
> #### Input Parameters
>
> **task\_id** `integer` *required*
>
> Task ID returned by SEARCH\_TASKS, CREATE\_TASK, or another task response.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List boards
>
> **Slug:** `KANBAN_TOOL_LIST_BOARDS`
>
> List boards available to the connected Kanban Tool user, including each board's permissions and account feature/tier context.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search tasks
>
> **Slug:** `KANBAN_TOOL_SEARCH_TASKS`
>
> Search visible tasks with Kanban Tool query syntax and return one page plus a continuation cursor. Supports board filtering and archived tasks.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Results per page. The provider publishes no maximum.
>
> **query** `string`
>
> Full-text or Kanban Tool filter expression. Examples: 'release notes', 'name:Deploy', 'priority:1', 'tags:"external work"', or 'due\_date=2026-09-01'. Use an empty string to list visible tasks.
>
> **cursor** `string`
>
> Opaque continuation cursor returned by a prior call; omit for the first page.
>
> **board\_ids** `array`
>
> Board IDs to search. Omit to search every accessible board.
>
> **include\_archived** `boolean`
>
> Whether to include archived tasks in the search.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update subtask
>
> **Slug:** `KANBAN_TOOL_UPDATE_SUBTASK`
>
> Update a subtask's name, assignee, or completion state.
>
> #### Input Parameters
>
> **name** `string`
>
> New subtask name.
>
> **subtask\_id** `integer` *required*
>
> Subtask to update.
>
> **is\_completed** `boolean`
>
> New completion state.
>
> **assigned\_user\_id** `integer`
>
> New assignee; explicitly pass null to clear.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update task
>
> **Slug:** `KANBAN_TOOL_UPDATE_TASK`
>
> Update a task's content, placement, assignment, estimates, dates, tags, or external references. Use CHANGE\_TASK\_LIFECYCLE to archive, delete, or restore it.
>
> #### Input Parameters
>
> **name** `string`
>
> New task name.
>
> **tags** `array`
>
> Replacement tag list; sent as comma-separated text. Pass an empty list to clear tags.
>
> **task\_id** `integer` *required*
>
> Task to update.
>
> **board\_id** `integer`
>
> Move to this board.
>
> **due\_date** `string`
>
> New due date in YYYY-MM-DD format; explicitly pass null to clear.
>
> **position** `integer`
>
> New position.
>
> **priority** `integer ("-1" | "0" | "1")`
>
> Priority: -1 low, 0 normal, or 1 high.
>
> **description** `string`
>
> New description.
>
> **external\_id** `string`
>
> New external identifier as an integer or string; explicitly pass null to clear.
>
> **swimlane\_id** `integer`
>
> Move to this swimlane.
>
> **card\_type\_id** `integer`
>
> Set this card type.
>
> **external\_link** `string`
>
> New external URL; explicitly pass null to clear.
>
> **size\_estimate** `number`
>
> New size estimate; explicitly pass null to clear if supported.
>
> **time\_estimate** `number`
>
> New estimate; explicitly pass null to clear if supported by the account.
>
> **postponed\_until** `string`
>
> New postponed-through date in YYYY-MM-DD format; explicitly pass null to clear.
>
> **assigned\_user\_id** `integer`
>
> Assign this user; explicitly pass null to clear assignment.
>
> **workflow\_stage\_id** `integer`
>
> Move to this workflow stage.
>
> **recurring\_schedule** `string`
>
> Recurring-task schedule as an ISO 8601 next-run date-time immediately followed by a JSON schedule object; explicitly pass null to clear. Requires the Recurring tasks power-up.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
