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.
| Name | Type | Reference |
|---|---|---|
| space_uidrequired | string | Space UID |
| iteration_idrequired | string | Iteration ID |
| Name | Value |
|---|---|
| Authorization | Bearer <token> |
| Content-Type | application/json |
| Name | Type | Constraints | Description |
|---|---|---|---|
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. |
| Description | Response type | Example |
|---|---|---|
| Success | Object |
| 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 |
| 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 |
| 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) 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 |
| Name | Type | Description |
|---|---|---|
| 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) |
| Description | Response type | Example |
|---|---|---|
| Invalid token | String |
| Description | Response type | Example |
|---|---|---|
| Feature is not supported by tariff | Object |
| Name | Type | Description |
|---|---|---|
| message | string | Error message |
| Description | Response type | Example |
|---|---|---|
| Forbidden | Response body does not exist |
| Description | Response type | Example |
|---|---|---|
| Iteration or card not found | Response body does not exist |
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!