Kaiten API

KaitenDevelopers

rest external webhooks webhooks scim user metadata imports addons

Update card blockers

PATCH

https://example.kaiten.ru/api/latest/cards/{card_id}/blockers/{id}

Path parameters

Name	Type	Reference
card_idrequired	integer	Card ID
idrequired	integer	Blocker ID

Headers

Name	Value
Content-Type	application/json

Attributes

schema

{
 "$schema": "http://json-schema.org/draft-06/schema",
 "type": "object",
 "properties": {
  "reason": {
   "type": "string",
   "minLength": 1,
   "maxLength": 4096,
   "description": "Block reason"
  },
  "blocker_card_id": {
   "type": "integer",
   "description": "Blocker card ID"
  },
  "due_date": {
   "oneOf": [
    {
     "type": "string",
     "format": "date-time",
     "description": "Block deadline. ISO 8601 format"
    },
    {
     "type": "null",
     "description": "Empty due date"
    }
   ]
  },
  "due_date_time_present": {
   "oneOf": [
    {
     "type": "boolean",
     "description": "Is time present"
    },
    {
     "type": "null",
     "description": "Empty time present"
    }
   ]
  }
 },
 "anyOf": [
  {
   "required": [
    "reason"
   ]
  },
  {
   "required": [
    "blocker_card_id"
   ]
  }
 ]
}

Name	Type	Constraints	Description
reason	string	minLength: 1 maxLength: 4096	Block reason
blocker_card_id	integer		Blocker card ID
due_date	string		Block deadline. ISO 8601 format
due_date	null		Empty due date
due_date_time_present	boolean		Is time present
due_date_time_present	null		Empty time present

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	Blocker id
reason	string	Block reason
card_id	integer	Blocked card id
blocker_id	integer	User id who blocked card
blocker_card_id	string	Id of blocking card
blocker_card_title	null \|\| string	Title of blocking card
released	boolean	Is block released
released_by_id	integer	Id of user who released block
due_date	null \| string	Block deadline
due_date_time_present	boolean	Flag indicating that deadline is specified up to hours and minutes

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

card_id

Raw Body(json format)

  1  curl --request PATCH \
  2       --url 'https://example.kaiten.ru/api/latest/cards/{card_id}/blockers/{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!