Kanboard

App · 12 actions

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.

Actions

ActionWhat it does
Add commentComment on a task, as the connected user.
Add subtaskAdd a subtask, a step of the task to tick off, with someone to do it and a time estimate.
Close taskClose a task, as when it's finished.
Create taskAdd 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.
Delete taskDelete a task with its comments and subtasks, for good: Kanboard has no bin to restore it from.
Find tasksFind 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.
Get taskGet a task's details, with its comments and subtasks if you ask for them.
List columnsList a project's columns, left to right, and its swimlanes, with their IDs.
List projectsList the projects the connected user is a member of, with their IDs.
Move taskMove a task to another column or swimlane of its board, such as to Done, at the top or bottom of the column.
Reopen taskOpen a closed task again, back on the board in the column it was in.
Update taskChange a task's title, description, assignee, dates, colour, category, priority, tags, reference or complexity.

Add comment

Comment on a task, as the connected user.

Inputs

TasktasktextRequired
The task's ID (the number after # on its card) or its link.
CommentcommenttextRequired
What to write, in plain text or Markdown.

Outputs

authortext
The username of who wrote it
author_nametext
The name of who wrote it
commenttext
The comment, in Markdown
created_attext
When it was written (ISO 8601, UTC)
idnumber
The comment's ID
linktext
A link to the comment in Kanboard
task_idnumber
The task's ID
Example output
{
  "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

TasktasktextRequired
The task's ID (the number after # on its card) or its link.
TitletitletextRequired
What the step is.
Assigneeassigneetext
Who will do it: someone the project's tasks can be assigned to, or me.
Time estimatetime_estimatednumber
How long it should take, in hours.At least 0.

Outputs

assigneetext
The username of who it's assigned to; empty if no one
assignee_nametext
The name of who it's assigned to; empty if no one
donetrue/false
Whether it's done
idnumber
The subtask's ID
statustext
To do, In progress or Done
task_idnumber
The task it belongs to
time_estimatednumber
The time it's expected to take, in hours
time_spentnumber
The time spent on it, in hours
titletext
What it is
Example output
{
  "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

TasktasktextRequired
The task's ID (the number after # on its card) or its link.

Outputs

assigneetext
The username of who it's assigned to; empty if no one
assignee_idnumber
The user ID of who it's assigned to; 0 if no one
assignee_nametext
The name of who it's assigned to; empty if no one
categorytext
Its category; empty if none
category_idnumber
Its category's ID; 0 if none
closed_attext
When it was closed (ISO 8601, UTC); empty if open
colortext
Its colour's name, such as Yellow
color_idtext
Its colour's ID, such as yellow or deep_orange
columntext
The column it's in, such as Ready
column_idnumber
The column's ID
comment_countnumber
How many comments it has
complexitynumber
Its complexity (Kanboard's score); 0 if not set
created_attext
When it was created (ISO 8601, UTC)
descriptiontext
Its description, in Markdown
due_datetext
When it's due (ISO 8601, UTC); empty if no due date
idnumber
The task's ID, shown as #42 in Kanboard
linktext
A link to it in Kanboard
moved_attext
When it last moved to another column or swimlane (ISO 8601, UTC)
positionnumber
Its place in its column, from 1 at the top
prioritynumber
Its priority, a number from the project's range (0 to 3 unless changed)
projecttext
The project it's in
project_idnumber
The project's ID
referencetext
Its reference, such as an invoice or ticket number; may be empty
start_datetext
When it starts (ISO 8601, UTC); empty if none
statustext
open or closed
subtask_countnumber
How many subtasks it has
subtasks_donenumber
How many of its subtasks are done
swimlanetext
The swimlane it's in
swimlane_idnumber
The swimlane's ID
tagslist
Its tags
titletext
Its title
updated_attext
When it last changed (ISO 8601, UTC)
Example output
{
  "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

ProjectprojecttextRequired
The project whose board it goes on.
TitletitletextRequired
What needs doing.
Columncolumntext
The column it starts in. Leave blank for the first column.
Swimlaneswimlanetext
The swimlane it goes in. Leave blank for the first one.
Descriptiondescriptiontext
The details, in plain text or Markdown.
Assigneeassigneetext
Who will do it: someone the project's tasks can be assigned to, or me.
Due datedue_datedate and time
When it's due.
Start datestart_datedate and time
When work on it starts.
Colourcolortext
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.
Categorycategorytext
One of the project's categories.
Tagstagslist
Tags to put on it. A tag the project doesn't have yet is made.
Priorityprioritynumber
A number from the project's priority range, 0 to 3 unless a project manager changed it.At least 0.
Referencereferencetext
A reference of your own, such as an invoice or ticket number.
Complexitycomplexitynumber
How big a job it is, as a whole number (Kanboard's complexity score).At least 0.

Outputs

assigneetext
The username of who it's assigned to; empty if no one
assignee_idnumber
The user ID of who it's assigned to; 0 if no one
assignee_nametext
The name of who it's assigned to; empty if no one
categorytext
Its category; empty if none
category_idnumber
Its category's ID; 0 if none
closed_attext
When it was closed (ISO 8601, UTC); empty if open
colortext
Its colour's name, such as Yellow
color_idtext
Its colour's ID, such as yellow or deep_orange
columntext
The column it's in, such as Ready
column_idnumber
The column's ID
comment_countnumber
How many comments it has
complexitynumber
Its complexity (Kanboard's score); 0 if not set
created_attext
When it was created (ISO 8601, UTC)
descriptiontext
Its description, in Markdown
due_datetext
When it's due (ISO 8601, UTC); empty if no due date
idnumber
The task's ID, shown as #42 in Kanboard
linktext
A link to it in Kanboard
moved_attext
When it last moved to another column or swimlane (ISO 8601, UTC)
positionnumber
Its place in its column, from 1 at the top
prioritynumber
Its priority, a number from the project's range (0 to 3 unless changed)
projecttext
The project it's in
project_idnumber
The project's ID
referencetext
Its reference, such as an invoice or ticket number; may be empty
start_datetext
When it starts (ISO 8601, UTC); empty if none
statustext
open or closed
subtask_countnumber
How many subtasks it has
subtasks_donenumber
How many of its subtasks are done
swimlanetext
The swimlane it's in
swimlane_idnumber
The swimlane's ID
tagslist
Its tags
titletext
Its title
updated_attext
When it last changed (ISO 8601, UTC)
Example output
{
  "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

TasktasktextRequired
The task's ID (the number after # on its card) or its link.

Outputs

deletedtrue/false
True once it's deleted
idnumber
The deleted task's ID
project_idnumber
The project it was in
titletext
Its title
Example output
{
  "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

Projectprojecttext
Only this project. Leave blank for every project you're in.
Open or closedstatustext
Which tasks to find.One of: open, closed, any (Both). Default: open.
Columncolumntext
Only tasks in this column.
Swimlaneswimlanetext
Only tasks in this swimlane.
Assigneeassigneetext
Only tasks assigned to this person, or me. Type nobody for unassigned tasks.
Categorycategorytext
Only tasks in this category.
Tagtagtext
Only tasks with this tag.
Dueduetext
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 containstexttext
Only tasks with this text in their title.
Searchquerytext
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`.
Ordersorttext
Which come first.One of: due (Soonest due), newest, priority (Highest priority), board (As on the board). Default: due.
How manylimitnumber
The most to list. Defaults to 25.From 1 to 200.

Outputs

countnumber
How many tasks were listed
has_moretrue/false
Whether more tasks match than were listed
taskslist
The tasks found
Example output
{
  "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

TasktasktextRequired
The task's ID (the number after # on its card) or its link.
Include commentsinclude_commentstrue/false
Also get its comments, oldest first.
Include subtasksinclude_subtaskstrue/false
Also get its subtasks.

Outputs

assigneetext
The username of who it's assigned to; empty if no one
assignee_idnumber
The user ID of who it's assigned to; 0 if no one
assignee_nametext
The name of who it's assigned to; empty if no one
categorytext
Its category; empty if none
category_idnumber
Its category's ID; 0 if none
closed_attext
When it was closed (ISO 8601, UTC); empty if open
colortext
Its colour's name, such as Yellow
color_idtext
Its colour's ID, such as yellow or deep_orange
columntext
The column it's in, such as Ready
column_idnumber
The column's ID
comment_countnumber
How many comments it has
commentslist
Its comments, oldest first, when asked for
complexitynumber
Its complexity (Kanboard's score); 0 if not set
created_attext
When it was created (ISO 8601, UTC)
descriptiontext
Its description, in Markdown
due_datetext
When it's due (ISO 8601, UTC); empty if no due date
idnumber
The task's ID, shown as #42 in Kanboard
linktext
A link to it in Kanboard
moved_attext
When it last moved to another column or swimlane (ISO 8601, UTC)
positionnumber
Its place in its column, from 1 at the top
prioritynumber
Its priority, a number from the project's range (0 to 3 unless changed)
projecttext
The project it's in
project_idnumber
The project's ID
referencetext
Its reference, such as an invoice or ticket number; may be empty
start_datetext
When it starts (ISO 8601, UTC); empty if none
statustext
open or closed
subtask_countnumber
How many subtasks it has
subtaskslist
Its subtasks, in order, when asked for
subtasks_donenumber
How many of its subtasks are done
swimlanetext
The swimlane it's in
swimlane_idnumber
The swimlane's ID
tagslist
Its tags
titletext
Its title
updated_attext
When it last changed (ISO 8601, UTC)
Example output
{
  "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

ProjectprojecttextRequired
The project whose board to read.

Outputs

columnslist
Its columns, left to right
countnumber
How many columns there are
project_idnumber
The project's ID
swimlaneslist
Its active swimlanes, top to bottom
Example output
{
  "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

countnumber
How many projects there are
projectslist
The projects the connected user is a member of
Example output
{
  "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

TasktasktextRequired
The task's ID (the number after # on its card) or its link.
Columncolumntext
The column to move it to. Leave blank to keep its column.
Swimlaneswimlanetext
The swimlane to move it to. Leave blank to keep its swimlane.
Positionpositiontext
Where in the column it goes.One of: bottom, top. Default: bottom.

Outputs

assigneetext
The username of who it's assigned to; empty if no one
assignee_idnumber
The user ID of who it's assigned to; 0 if no one
assignee_nametext
The name of who it's assigned to; empty if no one
categorytext
Its category; empty if none
category_idnumber
Its category's ID; 0 if none
closed_attext
When it was closed (ISO 8601, UTC); empty if open
colortext
Its colour's name, such as Yellow
color_idtext
Its colour's ID, such as yellow or deep_orange
columntext
The column it's in, such as Ready
column_idnumber
The column's ID
comment_countnumber
How many comments it has
complexitynumber
Its complexity (Kanboard's score); 0 if not set
created_attext
When it was created (ISO 8601, UTC)
descriptiontext
Its description, in Markdown
due_datetext
When it's due (ISO 8601, UTC); empty if no due date
idnumber
The task's ID, shown as #42 in Kanboard
linktext
A link to it in Kanboard
moved_attext
When it last moved to another column or swimlane (ISO 8601, UTC)
positionnumber
Its place in its column, from 1 at the top
prioritynumber
Its priority, a number from the project's range (0 to 3 unless changed)
projecttext
The project it's in
project_idnumber
The project's ID
referencetext
Its reference, such as an invoice or ticket number; may be empty
start_datetext
When it starts (ISO 8601, UTC); empty if none
statustext
open or closed
subtask_countnumber
How many subtasks it has
subtasks_donenumber
How many of its subtasks are done
swimlanetext
The swimlane it's in
swimlane_idnumber
The swimlane's ID
tagslist
Its tags
titletext
Its title
updated_attext
When it last changed (ISO 8601, UTC)
Example output
{
  "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

TasktasktextRequired
The task's ID (the number after # on its card) or its link.

Outputs

assigneetext
The username of who it's assigned to; empty if no one
assignee_idnumber
The user ID of who it's assigned to; 0 if no one
assignee_nametext
The name of who it's assigned to; empty if no one
categorytext
Its category; empty if none
category_idnumber
Its category's ID; 0 if none
closed_attext
When it was closed (ISO 8601, UTC); empty if open
colortext
Its colour's name, such as Yellow
color_idtext
Its colour's ID, such as yellow or deep_orange
columntext
The column it's in, such as Ready
column_idnumber
The column's ID
comment_countnumber
How many comments it has
complexitynumber
Its complexity (Kanboard's score); 0 if not set
created_attext
When it was created (ISO 8601, UTC)
descriptiontext
Its description, in Markdown
due_datetext
When it's due (ISO 8601, UTC); empty if no due date
idnumber
The task's ID, shown as #42 in Kanboard
linktext
A link to it in Kanboard
moved_attext
When it last moved to another column or swimlane (ISO 8601, UTC)
positionnumber
Its place in its column, from 1 at the top
prioritynumber
Its priority, a number from the project's range (0 to 3 unless changed)
projecttext
The project it's in
project_idnumber
The project's ID
referencetext
Its reference, such as an invoice or ticket number; may be empty
start_datetext
When it starts (ISO 8601, UTC); empty if none
statustext
open or closed
subtask_countnumber
How many subtasks it has
subtasks_donenumber
How many of its subtasks are done
swimlanetext
The swimlane it's in
swimlane_idnumber
The swimlane's ID
tagslist
Its tags
titletext
Its title
updated_attext
When it last changed (ISO 8601, UTC)
Example output
{
  "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

TasktasktextRequired
The task's ID (the number after # on its card) or its link.
Titletitletext
A new title. Leave blank to keep it.
Descriptiondescriptiontext
A new description, plain text or Markdown, replacing the old one. Leave blank to keep it.
Assigneeassigneetext
Assign it to someone else, or to me. Type nobody to unassign it. Leave blank to keep it.
Due datedue_datedate and time
A new due date. Leave blank to keep it.
Start datestart_datedate and time
A new start date. Leave blank to keep it.
Colourcolortext
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.
Categorycategorytext
A new category from the task's project. Type none to remove it. Leave blank to keep it.
Priorityprioritynumber
A new priority from the project's range. Leave blank to keep it.At least 0.
Add tagsadd_tagslist
Tags to add. Its other tags stay. A tag the project doesn't have yet is made.
Remove tagsremove_tagslist
Tags to take off.
Referencereferencetext
A new reference. Leave blank to keep it.
Complexitycomplexitynumber
A new complexity score. Leave blank to keep it.At least 0.

Outputs

assigneetext
The username of who it's assigned to; empty if no one
assignee_idnumber
The user ID of who it's assigned to; 0 if no one
assignee_nametext
The name of who it's assigned to; empty if no one
categorytext
Its category; empty if none
category_idnumber
Its category's ID; 0 if none
closed_attext
When it was closed (ISO 8601, UTC); empty if open
colortext
Its colour's name, such as Yellow
color_idtext
Its colour's ID, such as yellow or deep_orange
columntext
The column it's in, such as Ready
column_idnumber
The column's ID
comment_countnumber
How many comments it has
complexitynumber
Its complexity (Kanboard's score); 0 if not set
created_attext
When it was created (ISO 8601, UTC)
descriptiontext
Its description, in Markdown
due_datetext
When it's due (ISO 8601, UTC); empty if no due date
idnumber
The task's ID, shown as #42 in Kanboard
linktext
A link to it in Kanboard
moved_attext
When it last moved to another column or swimlane (ISO 8601, UTC)
positionnumber
Its place in its column, from 1 at the top
prioritynumber
Its priority, a number from the project's range (0 to 3 unless changed)
projecttext
The project it's in
project_idnumber
The project's ID
referencetext
Its reference, such as an invoice or ticket number; may be empty
start_datetext
When it starts (ISO 8601, UTC); empty if none
statustext
open or closed
subtask_countnumber
How many subtasks it has
subtasks_donenumber
How many of its subtasks are done
swimlanetext
The swimlane it's in
swimlane_idnumber
The swimlane's ID
tagslist
Its tags
titletext
Its title
updated_attext
When it last changed (ISO 8601, UTC)
Example output
{
  "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"
}

On this page