Kaiten API

KaitenDevelopers

rest external webhooks webhooks scim user metadata imports addons

Create new board

POST

https://example.kaiten.ru/api/latest/spaces/{space_id}/boards

Path parameters

Name	Type	Reference
space_idrequired	integer	Space ID

Headers

Name	Value
Content-Type	application/json

Attributes

schema

{
 "$schema": "http://json-schema.org/draft-06/schema",
 "type": "object",
 "properties": {
  "title": {
   "oneOf": [
    {
     "type": "string",
     "minLength": 1,
     "maxLength": 128,
     "description": "Title of the new board"
    },
    {
     "type": "number"
    }
   ]
  },
  "columns": {
   "type": "array",
   "description": "Board columns.\nIf not passed, a default column will be created.\nIf an empty array is passed, an error will be returned.\nPreviously created boards without columns will not be included in responses, except for requests by ID, until they have at least one column and one track.",
   "items": {
    "type": "object",
    "properties": {
     "title": {
      "type": "string",
      "minLength": 0,
      "maxLength": 128,
      "description": "Title"
     },
     "sort_order": {
      "type": "number",
      "description": "Position",
      "exclusiveMinimum": 0
     },
     "type": {
      "enum": [
       1,
       2,
       3
      ],
      "description": "1 - queue, 2 – in progress, 3 – done"
     },
     "wip_limit": {
      "type": "integer",
      "description": "Work in progress recommended limit for column"
     },
     "col_count": {
      "type": "integer",
      "description": "Width"
     },
     "archive_after_days": {
      "type": "integer",
      "description": "Specify amont of days after which cards will be automatically archived. Works only for columns with type **done**"
     },
     "months_to_hide_cards": {
      "type": [
       "integer",
       "null"
      ],
      "description": "[Deprecated] Hide cards not moved for the last N months"
     },
     "card_hide_after_days": {
      "type": [
       "integer",
       "null"
      ],
      "description": "Hide cards not moved for the last N days"
     },
     "rules": {
      "type": "integer",
      "minimum": 0,
      "description": "Bit mask for column rules. Rules: 1 - checklists must be checked, 2 - display FIFO order"
     },
     "default_tags": {
      "type": [
       "string",
       "null"
      ],
      "description": "Default tags"
     }
    },
    "required": [
     "title",
     "type"
    ]
   }
  },
  "lanes": {
   "type": "array",
   "description": "Board lanes.\nIf not passed, a default lane will be created.\nIf an empty array is passed, an error will be returned and the board will not be created.\nPreviously created boards without lanes will not be included in responses, except for requests by ID, until they have at least one column and one lane.",
   "items": {
    "type": "object",
    "properties": {
     "title": {
      "type": "string",
      "minLength": 0,
      "maxLength": 128,
      "description": "Title"
     },
     "sort_order": {
      "type": "number",
      "description": "Position",
      "exclusiveMinimum": 0
     },
     "wip_limit": {
      "type": "integer",
      "description": "Work in progress recommended limit for lane"
     },
     "row_count": {
      "type": "integer",
      "description": "Height"
     },
     "default_tags": {
      "type": [
       "string",
       "null"
      ],
      "description": "Default tags"
     }
    },
    "required": [
     "title"
    ]
   }
  },
  "description": {
   "oneOf": [
    {
     "type": "string",
     "description": "Description"
    },
    {
     "type": "null",
     "description": "Description"
    }
   ]
  },
  "top": {
   "type": "integer",
   "description": "Y coordinate of the board on space"
  },
  "left": {
   "type": "integer",
   "description": "X coordinate of the board on space"
  },
  "default_card_type_id": {
   "type": "integer",
   "description": "Default card type for new cards on board"
  },
  "first_image_is_cover": {
   "type": "boolean",
   "description": "Automatically mark first uploaded card's image as card's cover"
  },
  "reset_lane_spent_time": {
   "type": "boolean",
   "description": "Reset lane spent time when card changed lane"
  },
  "automove_cards": {
   "type": "boolean",
   "description": "Automatically move cards depending on their children state"
  },
  "backward_moves_enabled": {
   "type": "boolean",
   "description": "Allow automatic backward movement for summary boards"
  },
  "auto_assign_enabled": {
   "type": "boolean",
   "description": "Automatically assign the author as a member (or responsible if the first member) when a card is moved to the column with type \"in progress\" or \"done\""
  },
  "sort_order": {
   "type": "number",
   "description": "Position",
   "exclusiveMinimum": 0
  },
  "external_id": {
   "oneOf": [
    {
     "type": [
      "number",
      "string"
     ],
     "maxLength": 1024,
     "description": "Any external id you want to assign to board. Not exposed in web interface"
    },
    {
     "type": "null",
     "description": "Any external id you want to assign to board. Not exposed in web interface"
    }
   ]
  }
 },
 "required": [
  "title"
 ]
}

Name	Type	Constraints	Description
titlerequired	string	minLength: 1 maxLength: 128	Title of the new board
titlerequired	number
columns	array of objects Schema		Board columns. If not passed, a default column will be created. If an empty array is passed, an error will be returned. Previously created boards without columns will not be included in responses, except for requests by ID, until they have at least one column and one track.
lanes	array of objects Schema		Board lanes. If not passed, a default lane will be created. If an empty array is passed, an error will be returned and the board will not be created. Previously created boards without lanes will not be included in responses, except for requests by ID, until they have at least one column and one lane.
description	string \| null		Description
top	integer		Y coordinate of the board on space
left	integer		X coordinate of the board on space
default_card_type_id	integer		Default card type for new cards on board
first_image_is_cover	boolean		Automatically mark first uploaded card's image as card's cover
reset_lane_spent_time	boolean		Reset lane spent time when card changed lane
automove_cards	boolean		Automatically move cards depending on their children state
backward_moves_enabled	boolean		Allow automatic backward movement for summary boards
auto_assign_enabled	boolean		Automatically assign the author as a member (or responsible if the first member) when a card is moved to the column with type "in progress" or "done"
sort_order	number	exclusiveMinimum: 0	Position
external_id	number \| string \| null		Any external id you want to assign to board. Not exposed in web interface

Responses

200

Description	Response type	Example
Success	Object	Open

Response Attributes

Name	Type	Description
created	string	Create date
updated	string	Last update timestamp
id	integer	Board id
title	string	Board title
cell_wip_limits	null \| array	JSON containing wip limits rules for cells
external_id	null \| string	External id
default_card_type_id	integer	Default card type for new cards on board
description	string	Board description
email_key	string	Email key
move_parents_to_done	boolean	Automatically move parent cards to done when their children cards on this board is done
default_tags	null \| string	Default tags
first_image_is_cover	boolean	Automatically mark first uploaded card's image as card's cover
reset_lane_spent_time	boolean	Reset lane spent time when card changed lane
backward_moves_enabled	boolean	Allow automatic backward movement for summary boards
hide_done_policies	boolean	Hide done checklist policies
hide_done_policies_in_done_column	boolean	Hide done checklist policies only in done column
automove_cards	boolean	Automatically move cards depending on their children state
auto_assign_enabled	boolean	Automatically assign a user to the card when he/she moves the card if the user is not a member of the card
card_properties	null \| array of objects Schema	Properties of the board cards suggested for filling
columns	array of objects Schema	Board columns
lanes	array of objects Schema	Board lanes
top	integer	Y coordinate of the board on space
left	integer	X coordinate of the board on space
sort_order	number	Position

400

Description	Response type	Example
Validation error	Object	Open

Response Attributes

Name	Type	Description
message	string	Error message

401

Description	Response type	Example
Invalid token	String	Open

A schema has not been defined for this response code.

402

Description	Response type	Example
Feature is not supported by tariff	Object	Open

Response Attributes

Name	Type	Description
message	string	Error message

403

Description	Response type	Example
Forbidden		Response body does not exist

A schema has not been defined for this response code.

404

Description	Response type	Example
Not found		Response body does not exist

A schema has not been defined for this response code.

Kaiten

Addons terms of use Personal data processing policy

If you have any questions or need help with integration feel free to write us at support@kaiten.io

Company domain

Path Parameters

space_id

Raw Body(json format)

  1  curl --request POST \
  2       --url 'https://example.kaiten.ru/api/latest/spaces/{space_id}/boards' \
  3       --header 'Accept: application/json' \
  4       --header 'Content-Type: application/json'
  5

Response

ClickTry It!to start a request and see the response here!