Kaiten API

KaitenDevelopers

rest external webhooks webhooks scim user metadata imports addons

Remove cards from iteration

DELETE

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. Restrictions support cardIteration with operator eq/ne and data.state any/active/planned. Membership includes open manual and board-derived participation anywhere in the company. any covers active and planned iterations only; closed, closing, removed and past participation are excluded. Iteration actions use operator eq and empty data. Configure Definition of Ready as separate ordinary restrictions for each violation. These checks also apply to explicit iteration automation actions; state-change and WIP conditions cannot be used with iteration actions.

Removes explicit manual memberships for 1–500 unique card UIDs. Cards outside the iteration are ignored. Active iteration removal restrictions apply. 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

Name	Type	Reference
space_uidrequired	string	Space UID
iteration_idrequired	string	Iteration ID

Headers

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

Attributes

Name	Type	Constraints	Description
card_uids required	array of strings

Responses

200

Description	Response type	Example
Success	Object	Response body does not exist

Response Attributes

Name	Type	Description
removed	Object[]	Removed manual membership records

400

Description	Response type	Example
The card cannot be removed from the iteration 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

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)

401

Description	Response type	Example
Invalid token	String	Open

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

404

Description	Response type	Example
Iteration or card not found		Response body does not exist

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 DELETE \
  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!