Skip to main content

Create a board

Create a board.

Parameters​

folder
string
Unique identifier for the folder in which the board will be created.
title
string
required
Title of the board.
visibility
enum
required
Visibility of the board. One of private, internal, shared.
role
enum
Only when visibility is internal. Used as the default role for all team members. If a user has a directly attached role, it will override this one. One of board_admin, board_manager, board_editor, board_full_creator, board_creator, board_commenter, board_viewer.

Returns​

Returns the created board object. Throws an error if some parameters are not valid.

post
/api/boards
curl -X POST https://{workspace}.kitchen.co/api/boards \
    -H 'Content-Type: application/json' \
    -H 'Accept: application/json' \
    -H 'X-Requested-With: XMLHttpRequest' \
    -H 'Authorization: Bearer {API_KEY}'
Response
{
  "archived_at": null,
  "created_at": "2024-03-21T07:32:03+00:00",
  "id": "tskb_5e22e833684835b70ea85e45",
  "title": "The board title",
  "updated_at": "2024-03-21T07:32:03+00:00",
  "visibility": "internal"
}