Kaiten API

KaitenDevelopers

rest external webhooks webhooks scim user metadata imports addons

Update card type

PATCH

https://example.kaiten.ru/api/latest/card-types/{id}

⚠️ The properties field is deprecated and will be removed after 31.01.2026. Use card_properties instead for defining card type properties.

Path parameters

Name	Type	Reference
idrequired	integer	Card Type ID

Headers

Name	Value
Content-Type	application/json

Attributes

schema

{
 "$schema": "http://json-schema.org/draft-06/schema",
 "type": "object",
 "properties": {
  "letter": {
   "type": "string",
   "minLength": 1,
   "maxLength": 11,
   "description": "Character that represents type. Maximum length for letters is 1 (length 11 is for emoji)"
  },
  "name": {
   "type": "string",
   "minLength": 1,
   "maxLength": 64,
   "description": "Type name"
  },
  "color": {
   "type": "integer",
   "minimum": 2,
   "maximum": 25,
   "description": "Color number"
  },
  "properties": {
   "type": "object",
   "description": "Properties of the card suggested for filling - old format, deprecated, use card_properties instead"
  },
  "card_properties": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "regular_property": {
      "oneOf": [
       {
        "type": "string",
        "enum": [
         "size",
         "due_date",
         "tags",
         "timeline",
         "description"
        ]
       },
       {
        "type": "null"
       }
      ],
      "description": "Key of the regular property"
     },
     "property_uid": {
      "oneOf": [
       {
        "type": "string",
        "format": "uuid"
       },
       {
        "type": "null"
       }
      ],
      "description": "UID of the custom property"
     },
     "sort_order": {
      "type": "number",
      "description": "Order of the property in the card"
     },
     "required": {
      "type": "boolean",
      "description": "If true, this property will be required to fill in the card"
     },
     "type_uid": {
      "type": "string",
      "description": "UID of the card type"
     }
    },
    "anyOf": [
     {
      "required": [
       "regular_property"
      ]
     },
     {
      "required": [
       "property_uid"
      ]
     }
    ]
   },
   "description": "Array of card properties that will be suggested for filling in cards of this type"
  },
  "suggest_fields": {
   "type": "boolean",
   "description": "If true, cards of this type will be offered to display additional fields based on statistics"
  }
 },
 "anyOf": [
  {
   "required": [
    "letter"
   ]
  },
  {
   "required": [
    "name"
   ]
  },
  {
   "required": [
    "color"
   ]
  },
  {
   "required": [
    "properties"
   ]
  }
 ]
}

Name	Type	Constraints	Description
letter	string	minLength: 1 maxLength: 11	Character that represents type. Maximum length for letters is 1 (length 11 is for emoji)
name	string	minLength: 1 maxLength: 64	Type name
color	integer	minimum: 2 maximum: 25	Color number
properties	object		Properties of the card suggested for filling - old format, deprecated, use card_properties instead
card_properties	array of objects Schema		Array of card properties that will be suggested for filling in cards of this type
suggest_fields	boolean		If true, cards of this type will be offered to display additional fields based on statistics

Responses

200

Description	Response type	Example
Success	Object	Open

Response Attributes

Name	Type	Description
company_id	integer	Company id
letter	string	Card type letter
name	string	Card type name
color	integer	Color number
updated	string	Last update timestamp
created	string	Create date
id	integer	Card type id
description_template	null \| string	Card type escription_template
propertiesDeprecated: use card_properties instead	null \| object Schema	Card type properties(preset and custom). Will be removed after 31.01.2026.
card_properties	array Schema	Array of card properties that will be suggested for filling in cards of this type
suggest_fields	boolean	If true, cards of this type will be offered to display additional fields based on statistics

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

Raw Body(json format)

  1  curl --request PATCH \
  2       --url 'https://example.kaiten.ru/api/latest/card-types/{id}' \
  3       --header 'Accept: application/json' \
  4       --header 'Content-Type: application/json'
  5

Response

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