Kaiten API

KaitenDevelopers

rest external webhooks webhooks scim user metadata imports addons

Add card to iteration

POST

https://example.kaiten.ru/api/latest/spaces/{space_uid}/iterations/{iteration_id}/cards

This endpoint is currently under active development. Parameters, attributes, and response formats are subject to change. Iterations API is in beta and may change.

Adds a card to an iteration. The card must be active and belong to one of the space's primary boards. Cards can be added to planned and active iterations only. Adding a card that belongs to another planned or active iteration moves it to the target iteration.

Path parameters

Name	Type	Reference
space_uidrequired	string	Space UID
iteration_idrequired	string	Iteration ID

Headers

Name	Value
Authorization	Bearer <token>
Content-Type	application/json

Attributes

schema

{
 "$schema": "http://json-schema.org/draft-06/schema",
 "type": "object",
 "properties": {
  "card_uid": {
   "type": "string",
   "minLength": 1,
   "description": "UID of the card to add to the iteration"
  }
 },
 "required": [
  "card_uid"
 ]
}

Name	Type	Constraints	Description
card_uid required	string	minLength: 1	UID of the card to add to the iteration

Responses

200

Description	Response type	Example
Success	Object	Open

Response Attributes

Name	Type	Description
iteration_id	string	ID of the iteration (UUID)
card_uid	string	UID of the card
added_by_uid	string	UID of the user who added the card to the iteration
removed_at	string \| null	Timestamp when the card was removed from the iteration, null if still active
removed_by_uid	string \| null	UID of the user who removed the card from the iteration, null if still active
sort_order	number	Sort order of the card within the iteration
created	string	Creation timestamp
updated	string	Last update timestamp

400

Description	Response type	Example
Validation error or card rule violation: card is not on a primary board of the space (code 2), iteration is not planned or active (code 3), or card is not active (code 4)	Object	Open

Response Attributes

Name	Type	Description
code	number	Numeric error code, present for business-rule violations
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
Iteration or card 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.ru

Company domain

Path Parameters

space_uid

iteration_id

Raw Body(json format)

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

Response

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