# Kanboard

> Run your kanban boards in Kanboard: create, update, move, close and find tasks, comment, add subtasks, and start a workflow when a task is created, moved or closed.

App · 12 actions. Web page: https://docs.lodol.com/docs/integrations/kanboard

## Actions

### Add comment

Comment on a task, as the connected user.

**Inputs**

- Task (`task`, text, required): The task's ID (the number after # on its card) or its link.
- Comment (`comment`, text, required): What to write, in plain text or Markdown.

**Outputs**

- `author` (text): The username of who wrote it
- `author_name` (text): The name of who wrote it
- `comment` (text): The comment, in Markdown
- `created_at` (text): When it was written (ISO 8601, UTC)
- `id` (number): The comment's ID
- `link` (text): A link to the comment in Kanboard
- `task_id` (number): The task's ID

**Example output**

```json
{
  "author": "alice",
  "author_name": "Alice Example",
  "comment": "Paid by card, receipt in the shared folder.",
  "created_at": "2026-11-06T09:12:00Z",
  "id": 7,
  "link": "https://kanboard.example.com/?controller=TaskViewController&action=show&task_id=42&project_id=1#comment-7",
  "task_id": 42
}
```

### Add subtask

Add a subtask, a step of the task to tick off, with someone to do it and a time estimate.

**Inputs**

- Task (`task`, text, required): The task's ID (the number after # on its card) or its link.
- Title (`title`, text, required): What the step is.
- Assignee (`assignee`, text): Who will do it: someone the project's tasks can be assigned to, or me.
- Time estimate (`time_estimated`, number): How long it should take, in hours. At least 0.

**Outputs**

- `assignee` (text): The username of who it's assigned to; empty if no one
- `assignee_name` (text): The name of who it's assigned to; empty if no one
- `done` (true/false): Whether it's done
- `id` (number): The subtask's ID
- `status` (text): To do, In progress or Done
- `task_id` (number): The task it belongs to
- `time_estimated` (number): The time it's expected to take, in hours
- `time_spent` (number): The time spent on it, in hours
- `title` (text): What it is

**Example output**

```json
{
  "assignee": "bob",
  "assignee_name": "Bob Builder",
  "done": false,
  "id": 5,
  "status": "To do",
  "task_id": 42,
  "time_estimated": 0.5,
  "time_spent": 0,
  "title": "Check the amount"
}
```

### Close task

Close a task, as when it's finished. It stays in its column, hidden from the board. A closed task is left as it is.

**Inputs**

- Task (`task`, text, required): The task's ID (the number after # on its card) or its link.

**Outputs**

- `assignee` (text): The username of who it's assigned to; empty if no one
- `assignee_id` (number): The user ID of who it's assigned to; 0 if no one
- `assignee_name` (text): The name of who it's assigned to; empty if no one
- `category` (text): Its category; empty if none
- `category_id` (number): Its category's ID; 0 if none
- `closed_at` (text): When it was closed (ISO 8601, UTC); empty if open
- `color` (text): Its colour's name, such as Yellow
- `color_id` (text): Its colour's ID, such as yellow or deep_orange
- `column` (text): The column it's in, such as Ready
- `column_id` (number): The column's ID
- `comment_count` (number): How many comments it has
- `complexity` (number): Its complexity (Kanboard's score); 0 if not set
- `created_at` (text): When it was created (ISO 8601, UTC)
- `description` (text): Its description, in Markdown
- `due_date` (text): When it's due (ISO 8601, UTC); empty if no due date
- `id` (number): The task's ID, shown as #42 in Kanboard
- `link` (text): A link to it in Kanboard
- `moved_at` (text): When it last moved to another column or swimlane (ISO 8601, UTC)
- `position` (number): Its place in its column, from 1 at the top
- `priority` (number): Its priority, a number from the project's range (0 to 3 unless changed)
- `project` (text): The project it's in
- `project_id` (number): The project's ID
- `reference` (text): Its reference, such as an invoice or ticket number; may be empty
- `start_date` (text): When it starts (ISO 8601, UTC); empty if none
- `status` (text): open or closed
- `subtask_count` (number): How many subtasks it has
- `subtasks_done` (number): How many of its subtasks are done
- `swimlane` (text): The swimlane it's in
- `swimlane_id` (number): The swimlane's ID
- `tags` (list): Its tags
- `title` (text): Its title
- `updated_at` (text): When it last changed (ISO 8601, UTC)

**Example output**

```json
{
  "assignee": "bob",
  "assignee_id": 3,
  "assignee_name": "Bob Builder",
  "category": "Finance",
  "category_id": 1,
  "closed_at": "",
  "color": "Red",
  "color_id": "red",
  "column": "Ready",
  "column_id": 2,
  "comment_count": 0,
  "complexity": 3,
  "created_at": "2026-11-05T19:34:22Z",
  "description": "The bill came by email on Monday.",
  "due_date": "2026-11-10T17:00:00Z",
  "id": 42,
  "link": "https://kanboard.example.com/?controller=TaskViewController&action=show&task_id=42&project_id=1",
  "moved_at": "2026-11-05T19:34:22Z",
  "position": 1,
  "priority": 2,
  "project": "Office",
  "project_id": 1,
  "reference": "INV-1042",
  "start_date": "",
  "status": "open",
  "subtask_count": 1,
  "subtasks_done": 0,
  "swimlane": "Default swimlane",
  "swimlane_id": 1,
  "tags": [
    "invoice"
  ],
  "title": "Pay the electricity bill",
  "updated_at": "2026-11-05T19:34:22Z"
}
```

### Create task

Add a task to a board, such as one from a form, an email or an alert, in a column and swimlane, with an assignee, due date, colour, category, tags, priority and a description.

**Inputs**

- Project (`project`, text, required): The project whose board it goes on.
- Title (`title`, text, required): What needs doing.
- Column (`column`, text): The column it starts in. Leave blank for the first column.
- Swimlane (`swimlane`, text): The swimlane it goes in. Leave blank for the first one.
- Description (`description`, text): The details, in plain text or Markdown.
- Assignee (`assignee`, text): Who will do it: someone the project's tasks can be assigned to, or me.
- Due date (`due_date`, date and time): When it's due.
- Start date (`start_date`, date and time): When work on it starts.
- Colour (`color`, text): The card's colour. Leave blank for the project's default. One of: `yellow`, `blue`, `green`, `purple`, `red`, `orange`, `grey`, `brown`, `deep_orange` (Deep Orange), `dark_grey` (Dark Grey), and 6 more.
- Category (`category`, text): One of the project's categories.
- Tags (`tags`, list): Tags to put on it. A tag the project doesn't have yet is made.
- Priority (`priority`, number): A number from the project's priority range, 0 to 3 unless a project manager changed it. At least 0.
- Reference (`reference`, text): A reference of your own, such as an invoice or ticket number.
- Complexity (`complexity`, number): How big a job it is, as a whole number (Kanboard's complexity score). At least 0.

**Outputs**

- `assignee` (text): The username of who it's assigned to; empty if no one
- `assignee_id` (number): The user ID of who it's assigned to; 0 if no one
- `assignee_name` (text): The name of who it's assigned to; empty if no one
- `category` (text): Its category; empty if none
- `category_id` (number): Its category's ID; 0 if none
- `closed_at` (text): When it was closed (ISO 8601, UTC); empty if open
- `color` (text): Its colour's name, such as Yellow
- `color_id` (text): Its colour's ID, such as yellow or deep_orange
- `column` (text): The column it's in, such as Ready
- `column_id` (number): The column's ID
- `comment_count` (number): How many comments it has
- `complexity` (number): Its complexity (Kanboard's score); 0 if not set
- `created_at` (text): When it was created (ISO 8601, UTC)
- `description` (text): Its description, in Markdown
- `due_date` (text): When it's due (ISO 8601, UTC); empty if no due date
- `id` (number): The task's ID, shown as #42 in Kanboard
- `link` (text): A link to it in Kanboard
- `moved_at` (text): When it last moved to another column or swimlane (ISO 8601, UTC)
- `position` (number): Its place in its column, from 1 at the top
- `priority` (number): Its priority, a number from the project's range (0 to 3 unless changed)
- `project` (text): The project it's in
- `project_id` (number): The project's ID
- `reference` (text): Its reference, such as an invoice or ticket number; may be empty
- `start_date` (text): When it starts (ISO 8601, UTC); empty if none
- `status` (text): open or closed
- `subtask_count` (number): How many subtasks it has
- `subtasks_done` (number): How many of its subtasks are done
- `swimlane` (text): The swimlane it's in
- `swimlane_id` (number): The swimlane's ID
- `tags` (list): Its tags
- `title` (text): Its title
- `updated_at` (text): When it last changed (ISO 8601, UTC)

**Example output**

```json
{
  "assignee": "bob",
  "assignee_id": 3,
  "assignee_name": "Bob Builder",
  "category": "Finance",
  "category_id": 1,
  "closed_at": "",
  "color": "Red",
  "color_id": "red",
  "column": "Ready",
  "column_id": 2,
  "comment_count": 0,
  "complexity": 3,
  "created_at": "2026-11-05T19:34:22Z",
  "description": "The bill came by email on Monday.",
  "due_date": "2026-11-10T17:00:00Z",
  "id": 42,
  "link": "https://kanboard.example.com/?controller=TaskViewController&action=show&task_id=42&project_id=1",
  "moved_at": "2026-11-05T19:34:22Z",
  "position": 1,
  "priority": 2,
  "project": "Office",
  "project_id": 1,
  "reference": "INV-1042",
  "start_date": "",
  "status": "open",
  "subtask_count": 1,
  "subtasks_done": 0,
  "swimlane": "Default swimlane",
  "swimlane_id": 1,
  "tags": [
    "invoice"
  ],
  "title": "Pay the electricity bill",
  "updated_at": "2026-11-05T19:34:22Z"
}
```

### Delete task

Delete a task with its comments and subtasks, for good: Kanboard has no bin to restore it from.

**Inputs**

- Task (`task`, text, required): The task's ID (the number after # on its card) or its link.

**Outputs**

- `deleted` (true/false): True once it's deleted
- `id` (number): The deleted task's ID
- `project_id` (number): The project it was in
- `title` (text): Its title

**Example output**

```json
{
  "deleted": true,
  "id": 42,
  "project_id": 1,
  "title": "Pay the electricity bill"
}
```

### Find tasks

Find tasks by project, open or closed, column, swimlane, assignee, category, tag, when they're due or words in their title, or with Kanboard's own search. Soonest due first, unless you pick another order.

**Inputs**

- Project (`project`, text): Only this project. Leave blank for every project you're in.
- Open or closed (`status`, text): Which tasks to find. One of: `open`, `closed`, `any` (Both). Default: `open`.
- Column (`column`, text): Only tasks in this column.
- Swimlane (`swimlane`, text): Only tasks in this swimlane.
- Assignee (`assignee`, text): Only tasks assigned to this person, or me. Type nobody for unassigned tasks.
- Category (`category`, text): Only tasks in this category.
- Tag (`tag`, text): Only tasks with this tag.
- Due (`due`, text): Only tasks due then. Today and the next 7 days follow the time zone in your Kanboard settings. One of: `any` (Any time, or no due date), `overdue`, `today`, `next_7_days` (Today or in the next 6 days), `none` (No due date). Default: `any`.
- Title contains (`text`, text): Only tasks with this text in their title.
- Search (`query`, text): More filters in Kanboard's search syntax, as you'd type them in its search box, such as `due:<2026-12-01 priority:>=2 color:red` or `description:invoice`.
- Order (`sort`, text): Which come first. One of: `due` (Soonest due), `newest`, `priority` (Highest priority), `board` (As on the board). Default: `due`.
- How many (`limit`, number): The most to list. Defaults to 25. From 1 to 200.

**Outputs**

- `count` (number): How many tasks were listed
- `has_more` (true/false): Whether more tasks match than were listed
- `tasks` (list): The tasks found

**Example output**

```json
{
  "count": 1,
  "has_more": false,
  "tasks": [
    {
      "assignee": "bob",
      "assignee_id": 3,
      "assignee_name": "Bob Builder",
      "category": "Finance",
      "category_id": 1,
      "closed_at": "",
      "color": "Red",
      "color_id": "red",
      "column": "Ready",
      "column_id": 2,
      "comment_count": 0,
      "complexity": 3,
      "created_at": "2026-11-05T19:34:22Z",
      "description": "The bill came by email on Monday.",
      "due_date": "2026-11-10T17:00:00Z",
      "id": 42,
      "link": "https://kanboard.example.com/?controller=TaskViewController&action=show&task_id=42&project_id=1",
      "moved_at": "2026-11-05T19:34:22Z",
      "position": 1,
      "priority": 2,
      "project": "Office",
      "project_id": 1,
      "reference": "INV-1042",
      "start_date": "",
      "status": "open",
      "subtask_count": 1,
      "subtasks_done": 0,
      "swimlane": "Default swimlane",
      "swimlane_id": 1,
      "tags": [
        "invoice"
      ],
      "title": "Pay the electricity bill",
      "updated_at": "2026-11-05T19:34:22Z"
    }
  ]
}
```

### Get task

Get a task's details, with its comments and subtasks if you ask for them.

**Inputs**

- Task (`task`, text, required): The task's ID (the number after # on its card) or its link.
- Include comments (`include_comments`, true/false): Also get its comments, oldest first.
- Include subtasks (`include_subtasks`, true/false): Also get its subtasks.

**Outputs**

- `assignee` (text): The username of who it's assigned to; empty if no one
- `assignee_id` (number): The user ID of who it's assigned to; 0 if no one
- `assignee_name` (text): The name of who it's assigned to; empty if no one
- `category` (text): Its category; empty if none
- `category_id` (number): Its category's ID; 0 if none
- `closed_at` (text): When it was closed (ISO 8601, UTC); empty if open
- `color` (text): Its colour's name, such as Yellow
- `color_id` (text): Its colour's ID, such as yellow or deep_orange
- `column` (text): The column it's in, such as Ready
- `column_id` (number): The column's ID
- `comment_count` (number): How many comments it has
- `comments` (list): Its comments, oldest first, when asked for
- `complexity` (number): Its complexity (Kanboard's score); 0 if not set
- `created_at` (text): When it was created (ISO 8601, UTC)
- `description` (text): Its description, in Markdown
- `due_date` (text): When it's due (ISO 8601, UTC); empty if no due date
- `id` (number): The task's ID, shown as #42 in Kanboard
- `link` (text): A link to it in Kanboard
- `moved_at` (text): When it last moved to another column or swimlane (ISO 8601, UTC)
- `position` (number): Its place in its column, from 1 at the top
- `priority` (number): Its priority, a number from the project's range (0 to 3 unless changed)
- `project` (text): The project it's in
- `project_id` (number): The project's ID
- `reference` (text): Its reference, such as an invoice or ticket number; may be empty
- `start_date` (text): When it starts (ISO 8601, UTC); empty if none
- `status` (text): open or closed
- `subtask_count` (number): How many subtasks it has
- `subtasks` (list): Its subtasks, in order, when asked for
- `subtasks_done` (number): How many of its subtasks are done
- `swimlane` (text): The swimlane it's in
- `swimlane_id` (number): The swimlane's ID
- `tags` (list): Its tags
- `title` (text): Its title
- `updated_at` (text): When it last changed (ISO 8601, UTC)

**Example output**

```json
{
  "assignee": "bob",
  "assignee_id": 3,
  "assignee_name": "Bob Builder",
  "category": "Finance",
  "category_id": 1,
  "closed_at": "",
  "color": "Red",
  "color_id": "red",
  "column": "Ready",
  "column_id": 2,
  "comment_count": 0,
  "comments": [
    {
      "author": "alice",
      "author_name": "Alice Example",
      "comment": "Paid by card, receipt in the shared folder.",
      "created_at": "2026-11-06T09:12:00Z",
      "id": 7,
      "link": "https://kanboard.example.com/?controller=TaskViewController&action=show&task_id=42&project_id=1#comment-7",
      "task_id": 42
    }
  ],
  "complexity": 3,
  "created_at": "2026-11-05T19:34:22Z",
  "description": "The bill came by email on Monday.",
  "due_date": "2026-11-10T17:00:00Z",
  "id": 42,
  "link": "https://kanboard.example.com/?controller=TaskViewController&action=show&task_id=42&project_id=1",
  "moved_at": "2026-11-05T19:34:22Z",
  "position": 1,
  "priority": 2,
  "project": "Office",
  "project_id": 1,
  "reference": "INV-1042",
  "start_date": "",
  "status": "open",
  "subtask_count": 1,
  "subtasks": [
    {
      "assignee": "bob",
      "assignee_name": "Bob Builder",
      "done": false,
      "id": 5,
      "status": "To do",
      "task_id": 42,
      "time_estimated": 0.5,
      "time_spent": 0,
      "title": "Check the amount"
    }
  ],
  "subtasks_done": 0,
  "swimlane": "Default swimlane",
  "swimlane_id": 1,
  "tags": [
    "invoice"
  ],
  "title": "Pay the electricity bill",
  "updated_at": "2026-11-05T19:34:22Z"
}
```

### List columns

List a project's columns, left to right, and its swimlanes, with their IDs.

**Inputs**

- Project (`project`, text, required): The project whose board to read.

**Outputs**

- `columns` (list): Its columns, left to right
- `count` (number): How many columns there are
- `project_id` (number): The project's ID
- `swimlanes` (list): Its active swimlanes, top to bottom

**Example output**

```json
{
  "columns": [
    {
      "description": "",
      "id": 1,
      "position": 1,
      "task_limit": 0,
      "title": "Backlog"
    },
    {
      "description": "",
      "id": 2,
      "position": 2,
      "task_limit": 0,
      "title": "Ready"
    },
    {
      "description": "",
      "id": 3,
      "position": 3,
      "task_limit": 5,
      "title": "Work in progress"
    },
    {
      "description": "",
      "id": 4,
      "position": 4,
      "task_limit": 0,
      "title": "Done"
    }
  ],
  "count": 4,
  "project_id": 1,
  "swimlanes": [
    {
      "id": 1,
      "name": "Default swimlane",
      "position": 1
    }
  ]
}
```

### List projects

List the projects the connected user is a member of, with their IDs.

**Inputs**: None.

**Outputs**

- `count` (number): How many projects there are
- `projects` (list): The projects the connected user is a member of

**Example output**

```json
{
  "count": 1,
  "projects": [
    {
      "description": "Office jobs, shared with Bob.",
      "id": 1,
      "identifier": "OFFICE",
      "is_active": true,
      "is_private": false,
      "link": "https://kanboard.example.com/?controller=BoardViewController&action=show&project_id=1",
      "name": "Office"
    }
  ]
}
```

### Move task

Move a task to another column or swimlane of its board, such as to Done, at the top or bottom of the column.

**Inputs**

- Task (`task`, text, required): The task's ID (the number after # on its card) or its link.
- Column (`column`, text): The column to move it to. Leave blank to keep its column.
- Swimlane (`swimlane`, text): The swimlane to move it to. Leave blank to keep its swimlane.
- Position (`position`, text): Where in the column it goes. One of: `bottom`, `top`. Default: `bottom`.

**Outputs**

- `assignee` (text): The username of who it's assigned to; empty if no one
- `assignee_id` (number): The user ID of who it's assigned to; 0 if no one
- `assignee_name` (text): The name of who it's assigned to; empty if no one
- `category` (text): Its category; empty if none
- `category_id` (number): Its category's ID; 0 if none
- `closed_at` (text): When it was closed (ISO 8601, UTC); empty if open
- `color` (text): Its colour's name, such as Yellow
- `color_id` (text): Its colour's ID, such as yellow or deep_orange
- `column` (text): The column it's in, such as Ready
- `column_id` (number): The column's ID
- `comment_count` (number): How many comments it has
- `complexity` (number): Its complexity (Kanboard's score); 0 if not set
- `created_at` (text): When it was created (ISO 8601, UTC)
- `description` (text): Its description, in Markdown
- `due_date` (text): When it's due (ISO 8601, UTC); empty if no due date
- `id` (number): The task's ID, shown as #42 in Kanboard
- `link` (text): A link to it in Kanboard
- `moved_at` (text): When it last moved to another column or swimlane (ISO 8601, UTC)
- `position` (number): Its place in its column, from 1 at the top
- `priority` (number): Its priority, a number from the project's range (0 to 3 unless changed)
- `project` (text): The project it's in
- `project_id` (number): The project's ID
- `reference` (text): Its reference, such as an invoice or ticket number; may be empty
- `start_date` (text): When it starts (ISO 8601, UTC); empty if none
- `status` (text): open or closed
- `subtask_count` (number): How many subtasks it has
- `subtasks_done` (number): How many of its subtasks are done
- `swimlane` (text): The swimlane it's in
- `swimlane_id` (number): The swimlane's ID
- `tags` (list): Its tags
- `title` (text): Its title
- `updated_at` (text): When it last changed (ISO 8601, UTC)

**Example output**

```json
{
  "assignee": "bob",
  "assignee_id": 3,
  "assignee_name": "Bob Builder",
  "category": "Finance",
  "category_id": 1,
  "closed_at": "",
  "color": "Red",
  "color_id": "red",
  "column": "Ready",
  "column_id": 2,
  "comment_count": 0,
  "complexity": 3,
  "created_at": "2026-11-05T19:34:22Z",
  "description": "The bill came by email on Monday.",
  "due_date": "2026-11-10T17:00:00Z",
  "id": 42,
  "link": "https://kanboard.example.com/?controller=TaskViewController&action=show&task_id=42&project_id=1",
  "moved_at": "2026-11-05T19:34:22Z",
  "position": 1,
  "priority": 2,
  "project": "Office",
  "project_id": 1,
  "reference": "INV-1042",
  "start_date": "",
  "status": "open",
  "subtask_count": 1,
  "subtasks_done": 0,
  "swimlane": "Default swimlane",
  "swimlane_id": 1,
  "tags": [
    "invoice"
  ],
  "title": "Pay the electricity bill",
  "updated_at": "2026-11-05T19:34:22Z"
}
```

### Reopen task

Open a closed task again, back on the board in the column it was in. An open task is left as it is.

**Inputs**

- Task (`task`, text, required): The task's ID (the number after # on its card) or its link.

**Outputs**

- `assignee` (text): The username of who it's assigned to; empty if no one
- `assignee_id` (number): The user ID of who it's assigned to; 0 if no one
- `assignee_name` (text): The name of who it's assigned to; empty if no one
- `category` (text): Its category; empty if none
- `category_id` (number): Its category's ID; 0 if none
- `closed_at` (text): When it was closed (ISO 8601, UTC); empty if open
- `color` (text): Its colour's name, such as Yellow
- `color_id` (text): Its colour's ID, such as yellow or deep_orange
- `column` (text): The column it's in, such as Ready
- `column_id` (number): The column's ID
- `comment_count` (number): How many comments it has
- `complexity` (number): Its complexity (Kanboard's score); 0 if not set
- `created_at` (text): When it was created (ISO 8601, UTC)
- `description` (text): Its description, in Markdown
- `due_date` (text): When it's due (ISO 8601, UTC); empty if no due date
- `id` (number): The task's ID, shown as #42 in Kanboard
- `link` (text): A link to it in Kanboard
- `moved_at` (text): When it last moved to another column or swimlane (ISO 8601, UTC)
- `position` (number): Its place in its column, from 1 at the top
- `priority` (number): Its priority, a number from the project's range (0 to 3 unless changed)
- `project` (text): The project it's in
- `project_id` (number): The project's ID
- `reference` (text): Its reference, such as an invoice or ticket number; may be empty
- `start_date` (text): When it starts (ISO 8601, UTC); empty if none
- `status` (text): open or closed
- `subtask_count` (number): How many subtasks it has
- `subtasks_done` (number): How many of its subtasks are done
- `swimlane` (text): The swimlane it's in
- `swimlane_id` (number): The swimlane's ID
- `tags` (list): Its tags
- `title` (text): Its title
- `updated_at` (text): When it last changed (ISO 8601, UTC)

**Example output**

```json
{
  "assignee": "bob",
  "assignee_id": 3,
  "assignee_name": "Bob Builder",
  "category": "Finance",
  "category_id": 1,
  "closed_at": "",
  "color": "Red",
  "color_id": "red",
  "column": "Ready",
  "column_id": 2,
  "comment_count": 0,
  "complexity": 3,
  "created_at": "2026-11-05T19:34:22Z",
  "description": "The bill came by email on Monday.",
  "due_date": "2026-11-10T17:00:00Z",
  "id": 42,
  "link": "https://kanboard.example.com/?controller=TaskViewController&action=show&task_id=42&project_id=1",
  "moved_at": "2026-11-05T19:34:22Z",
  "position": 1,
  "priority": 2,
  "project": "Office",
  "project_id": 1,
  "reference": "INV-1042",
  "start_date": "",
  "status": "open",
  "subtask_count": 1,
  "subtasks_done": 0,
  "swimlane": "Default swimlane",
  "swimlane_id": 1,
  "tags": [
    "invoice"
  ],
  "title": "Pay the electricity bill",
  "updated_at": "2026-11-05T19:34:22Z"
}
```

### Update task

Change a task's title, description, assignee, dates, colour, category, priority, tags, reference or complexity. Only the fields you fill in change.

**Inputs**

- Task (`task`, text, required): The task's ID (the number after # on its card) or its link.
- Title (`title`, text): A new title. Leave blank to keep it.
- Description (`description`, text): A new description, plain text or Markdown, replacing the old one. Leave blank to keep it.
- Assignee (`assignee`, text): Assign it to someone else, or to me. Type nobody to unassign it. Leave blank to keep it.
- Due date (`due_date`, date and time): A new due date. Leave blank to keep it.
- Start date (`start_date`, date and time): A new start date. Leave blank to keep it.
- Colour (`color`, text): A new colour for the card. Leave blank to keep it. One of: `yellow`, `blue`, `green`, `purple`, `red`, `orange`, `grey`, `brown`, `deep_orange` (Deep Orange), `dark_grey` (Dark Grey), and 6 more.
- Category (`category`, text): A new category from the task's project. Type none to remove it. Leave blank to keep it.
- Priority (`priority`, number): A new priority from the project's range. Leave blank to keep it. At least 0.
- Add tags (`add_tags`, list): Tags to add. Its other tags stay. A tag the project doesn't have yet is made.
- Remove tags (`remove_tags`, list): Tags to take off.
- Reference (`reference`, text): A new reference. Leave blank to keep it.
- Complexity (`complexity`, number): A new complexity score. Leave blank to keep it. At least 0.

**Outputs**

- `assignee` (text): The username of who it's assigned to; empty if no one
- `assignee_id` (number): The user ID of who it's assigned to; 0 if no one
- `assignee_name` (text): The name of who it's assigned to; empty if no one
- `category` (text): Its category; empty if none
- `category_id` (number): Its category's ID; 0 if none
- `closed_at` (text): When it was closed (ISO 8601, UTC); empty if open
- `color` (text): Its colour's name, such as Yellow
- `color_id` (text): Its colour's ID, such as yellow or deep_orange
- `column` (text): The column it's in, such as Ready
- `column_id` (number): The column's ID
- `comment_count` (number): How many comments it has
- `complexity` (number): Its complexity (Kanboard's score); 0 if not set
- `created_at` (text): When it was created (ISO 8601, UTC)
- `description` (text): Its description, in Markdown
- `due_date` (text): When it's due (ISO 8601, UTC); empty if no due date
- `id` (number): The task's ID, shown as #42 in Kanboard
- `link` (text): A link to it in Kanboard
- `moved_at` (text): When it last moved to another column or swimlane (ISO 8601, UTC)
- `position` (number): Its place in its column, from 1 at the top
- `priority` (number): Its priority, a number from the project's range (0 to 3 unless changed)
- `project` (text): The project it's in
- `project_id` (number): The project's ID
- `reference` (text): Its reference, such as an invoice or ticket number; may be empty
- `start_date` (text): When it starts (ISO 8601, UTC); empty if none
- `status` (text): open or closed
- `subtask_count` (number): How many subtasks it has
- `subtasks_done` (number): How many of its subtasks are done
- `swimlane` (text): The swimlane it's in
- `swimlane_id` (number): The swimlane's ID
- `tags` (list): Its tags
- `title` (text): Its title
- `updated_at` (text): When it last changed (ISO 8601, UTC)

**Example output**

```json
{
  "assignee": "bob",
  "assignee_id": 3,
  "assignee_name": "Bob Builder",
  "category": "Finance",
  "category_id": 1,
  "closed_at": "",
  "color": "Red",
  "color_id": "red",
  "column": "Ready",
  "column_id": 2,
  "comment_count": 0,
  "complexity": 3,
  "created_at": "2026-11-05T19:34:22Z",
  "description": "The bill came by email on Monday.",
  "due_date": "2026-11-10T17:00:00Z",
  "id": 42,
  "link": "https://kanboard.example.com/?controller=TaskViewController&action=show&task_id=42&project_id=1",
  "moved_at": "2026-11-05T19:34:22Z",
  "position": 1,
  "priority": 2,
  "project": "Office",
  "project_id": 1,
  "reference": "INV-1042",
  "start_date": "",
  "status": "open",
  "subtask_count": 1,
  "subtasks_done": 0,
  "swimlane": "Default swimlane",
  "swimlane_id": 1,
  "tags": [
    "invoice"
  ],
  "title": "Pay the electricity bill",
  "updated_at": "2026-11-05T19:34:22Z"
}
```
