Kaiten API

KaitenDevelopers

rest external webhooks webhooks scim user metadata imports addons

Add item to checklist

POST

https://example.kaiten.ru/api/latest/cards/{card_id}/checklists/{checklist_id}/items

Path parameters

Name	Type	Reference
card_idrequired	integer	Card ID
checklist_idrequired	integer	Card CheckList ID

Headers

Name	Value
Content-Type	application/json

Attributes

schema

{
 "$schema": "http://json-schema.org/draft-06/schema",
 "type": "object",
 "properties": {
  "text": {
   "type": "string",
   "minLength": 1,
   "maxLength": 4096,
   "description": "Content of item"
  },
  "sort_order": {
   "type": "number",
   "description": "Position",
   "exclusiveMinimum": 0
  },
  "checked": {
   "type": "boolean",
   "description": "State"
  },
  "due_date": {
   "oneOf": [
    {
     "type": "string",
     "format": "date-time",
     "description": "Due date of checklist item in format YYYY-MM-DD, for example 2025-12-24"
    },
    {
     "type": "null",
     "description": "Due date of checklist item in format YYYY-MM-DD, for example 2025-12-24"
    }
   ]
  },
  "responsible_id": {
   "type": "integer",
   "description": "Responsible user id"
  }
 },
 "required": [
  "text"
 ]
}

Name	Type	Constraints	Description
text required	string	minLength: 1 maxLength: 4096	Content of item
sort_order	number	exclusiveMinimum: 0	Position
checked	boolean		State
due_date	string \| null		Due date of checklist item in format YYYY-MM-DD, for example 2025-12-24
responsible_id	integer		Responsible user id

Responses

200

Description	Response type	Example
Success	Object	Open

Response Attributes

Name	Type	Description
updated	string	Last update timestamp
created	string	Create date
id	integer	Card checklist item id
text	string	Checklist item text
sort_order	number	Position
checked	boolean	Flag indicating that checklist item checked
checker_id	null \| integer	User id who checked checklist item
user_id	index	Current user id
checked_at	null \| string	Date of check
responsible_id	null \| integer	User id who is responsible for checklist item
deleted	boolean	Flag indicating that checklist item deleted
due_date	null \| string	checklist item deadline

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.

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

card_id

checklist_id

Raw Body(json format)

  1  curl --request POST \
  2       --url 'https://example.kaiten.ru/api/latest/cards/{card_id}/checklists/{checklist_id}/items' \
  3       --header 'Accept: application/json' \
  4       --header 'Content-Type: application/json'
  5

Response

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