​

Add card to iteration

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

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. Company restrictions can prohibit addition (iterationAddition) and removal from the source active iteration (activeIterationRemoval). Batch requests accept card_uids (1–500 unique UIDs). Restrictions are checked for the entire request before the first write. A restriction violation rejects the whole request. Writes retain separate transactions of up to 100 cards; concurrent changes or later execution errors may leave earlier batches applied.

Path parameters
NameTypeReference
space_uidrequiredstringSpace UID
iteration_idrequiredstringIteration ID
Headers
NameValue
AuthorizationBearer <token>
Content-Typeapplication/json
Attributes
schema
NameTypeConstraintsDescription
card_uid
string
minLength: 1

UID of the card to add to the iteration

card_uids
array of strings

UIDs of cards to add. For batch requests, the response contains added, removed, skipped and ineligible arrays. A restriction refusal returns HTTP 400 with code 7.

Responses

200
DescriptionResponse typeExample
SuccessObject
Open
Response Attributes
NameTypeDescription
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
added

Object[]

Batch request only: added memberships
removed

Object[]

Batch request only: memberships removed from previous iterations
skipped

Object[]

Batch request only: memberships already in the target iteration
ineligible

string[]

Batch request only: cards that became ineligible concurrently
400
DescriptionResponse typeExample
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) Restriction refusal uses code 7 and includes restriction, card_id, card_uid and card_uids. The restriction contains the triggering action and its configured conditions.Object
Open
Response Attributes
NameTypeDescription
code

number

Numeric error code, present for business-rule violations
message

string

Error message
restriction

Object

Restriction that rejected the operation (code 7)
card_id

integer

First restricted card ID (code 7)
card_uid

string

First restricted card UID (code 7)
card_uids

string[]

UIDs rejected by the returned restriction, at most 500 (code 7)
401
DescriptionResponse typeExample
Invalid tokenString
Open
402
DescriptionResponse typeExample
Feature is not supported by tariffObject
Open
Response Attributes
NameTypeDescription
message

string

Error message
403
DescriptionResponse typeExample
ForbiddenResponse body does not exist
404
DescriptionResponse typeExample
Iteration or card not foundResponse body does not exist
logo
Kaiten
If you have any questions or need help with integration feel free to write us at support@kaiten.ru

Path Parameters

  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!