Skip to content
MockFlow DevelopersGet an API key

Create a Kanban board with columns and task cards for project management, sprint planning, and task tracking.

Updated 9 Nov 20262 min read

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

data
columnsobject[]required

Array of Kanban columns. Each column must have a different color.

Child attributes
idstringrequired

Unique column ID (e.g., col_1, col_2)

titlestringrequired

Column 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")

colorstringrequired

Column accent color. Use: #e91e63, #ff9800, #9c27b0, #4caf50, #2196f3

cardsobject[]required

Array of cards in this column

settingsobjectrequired

Board settings

Child attributes
showLabelsboolean

Defaults to true.

showAssigneesboolean

Defaults to true.

showDueDateboolean

Defaults to true.

cardSizestring

Defaults to normal.

backgroundColorstring

Defaults to #ffffff.

fontColorstring

Defaults to #172b4d.

listColorstring

Defaults to #f4f5f7.

listFontColorstring

Defaults to #172b4d.

boardTitlestring

Title 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

record
titlestringrequired
columnstring

The column it goes in; made when the board has none by that name.

descriptionstring
labelsarray | string
prioritystring

low, medium or high; anything else is left out.

dueDatestring
assigneesarray | string
keystring

Your 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"
    ]
  }
}
Was this page helpful?

Sign in to MockFlow

The same account you use in the app and on the API.

Forgot your password?
or
Continue with GoogleContinue with MicrosoftContinue with Apple