v1

latestOpenAPI 3.0.32026-07-12101432.4 KB

Kanban

createKanbanBoard

Creates a new Kanban board with the provided configuration.

A board must have a title and a config containing at least one dataset. Swimlanes and filters can be configured to display specific subsets of workflow tasks or entities.

post/v1/kanban/board

Request body

idstring

titlestring required

descriptionstring

created_atstring date-time

updated_atstring date-time

created_bystring

org_idstring

updated_bystring

shared_withstring[]

shared_with_orgboolean

ownersstring[]

Array of user IDs who have full ownership rights for this board (view, edit, delete)

Example request

{
  "title": "Board 1",
  "description": "Board description",
  "config": {
    "dataset": "workflow_tasks_overview",
    "swimlanes": [
      {
        "title": "Swimlane 1",
        "position": 1,
        "filter": {
          "items": [
            {
              "key": "assignee",
              "operator": "EQUALS",
              "value": "100020",
              "data_type": "string"
            }
          ],
          "combination": "OR"
        },
        "title_chip_variant": "success"
      }
    ],
    "card_config": {
      "fields": [
        "assignee"
      ]
    },
    "board_filter": {
      "items": [
        {
          "key": "assignee",
          "operator": "EQUALS",
          "value": "100020",
          "data_type": "string"
        }
      ],
      "combination": "OR"
    },
    "sorting": {
      "field": "created_at"
    },
    "search_query": "task 1"
  }
}

Response

Successfully created board