Kanban
Create a Kanban board with columns and task cards for project management, sprint planning, and task tracking.
Send "type": "kanban".
Create a Kanban board with columns and task cards for project management, sprint planning, and task tracking.
Also available as the MCP tool render_kanban. The same payload works through either surface.
Fields
columnsobject[]requiredArray of Kanban columns. Each column must have a different color.
Child attributes
idstringrequiredUnique column ID (e.g., col_1, col_2)
titlestringrequiredColumn title — topic-relevant category, NEVER a generic workflow stage like "To Do"/"In Progress"/"Done" (e.g. a marketing board gets "Content Strategy", "Social Media", "Paid Ads")
colorstringrequiredColumn accent color. Use: #e91e63, #ff9800, #9c27b0, #4caf50, #2196f3
cardsobject[]requiredArray of cards in this column
settingsobjectrequiredBoard settings
Child attributes
showLabelsbooleanDefaults to true.
showAssigneesbooleanDefaults to true.
showDueDatebooleanDefaults to true.
cardSizestringDefaults to normal.
backgroundColorstringDefaults to #ffffff.
fontColorstringDefaults to #172b4d.
listColorstringDefaults to #f4f5f7.
listFontColorstringDefaults to #172b4d.
boardTitlestringTitle of the Kanban board
Example
{
"type": "kanban",
"data": {
"columns": [
{
"id": "string",
"title": "Q4 Launch Planning",
"color": "string",
"cards": [
{
"id": "string",
"title": "Q4 Launch Planning",
"description": "string",
"assignees": [
"string"
],
"labels": [
"string"
],
"comments": [
{}
],
"dueDate": "string",
"priority": "low"
}
]
}
],
"settings": {
"showLabels": true,
"showAssignees": true,
"showDueDate": true,
"cardSize": "normal",
"backgroundColor": "#ffffff",
"fontColor": "#172b4d"
}
}
}
Add one record
POST /boards/{boardId}/items/{itemId}/records adds one of these to an item already on a board and leaves the rest of it as it is. Send the same key again to update that record instead of adding another.
Record fields
titlestringrequiredcolumnstringThe column it goes in; made when the board has none by that name.
descriptionstringlabelsarray | stringprioritystringlow, medium or high; anything else is left out.
dueDatestringassigneesarray | stringkeystringYour own id for this record, like an issue key. Sending the same key again updates and moves that record instead of adding another.
{
"record": {
"title": "Q4 Launch Planning",
"column": "string",
"description": "string",
"labels": [
"string"
],
"priority": "string",
"dueDate": "string",
"assignees": [
"string"
]
}
}