Kanban

createKanbanBoard

Changed on Oct 26, 2026

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

Base URL
https://kanban.sls.epilot.io
URL
https://kanban.sls.epilot.io/v1/kanban/board
Auth
- HTTP bearer
- or API key in header x-epilot-org-id

Request body

idstring

titlestring required

descriptionstring

created_atstring date-time

updated_atstring date-time

created_bystring

org_idstring

updated_bystring

shared_with_orgboolean

Whether the board is shared with the whole organization (equivalent to org_access being set)

org_access'view' | 'edit'

Access level of a share. view is read-only. edit can additionally change the board configuration and title, but cannot delete the board, change sharing or change owners (owners only).

ownersstring[]

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

my_access'owner' | 'edit' | 'view'

Access level of the calling user. Only returned by getKanbanBoard.

Example request

{
  "title": "Board 1",
  "description": "Board description",
  "shared_with": [
    {
      "user_id": "group_abc"
    }
  ],
  "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