Kaiten API

KaitenDevelopers

rest external webhooks webhooks scim user metadata imports addons

Get card iterations history

GET

https://example.kaiten.ru/api/latest/cards/{card_uid}/iterations-history

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

Returns all iteration membership records for the card without pagination, ordered by created descending (the date the card was added). Each record represents an addition and, when removed_at is present, a removal; this is not a chronologically sorted list of individual events. Requires access to the card through card.read or card.read_own. With with_details omitted or false, the original response is unchanged and records for removed iterations are included. With with_details=true, removed iterations are excluded and iteration metadata and event authors are included. This mode additionally requires iteration.read in the card access check. Access to each historical iteration is checked separately using iteration.read on its space: inaccessible iterations remain in the history, but their title and space_uid are omitted.

Path parameters

Name	Type	Reference
card_uidrequired	string	Card UID

Headers

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

Query

Name	Type	Constraints	Description
with_details	boolean		Default: false. Set to true to include iteration metadata and event authors and exclude removed iterations. Requires iteration.read in addition to access to the card. Omit or set to false to keep the original response.

Responses

200

Description	Response type	Example
Returned when with_details is omitted or false. The original response schema is preserved.	Array of objects	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	Removal timestamp, or null when no removal is recorded. Null does not imply that the iteration is still active.
removed_by_uid	string \| null	UID of the user who removed the card, or null when no removal author is recorded.
sort_order	number	Sort order of the card within the iteration
created	string	Creation timestamp
updated	string	Last update timestamp

200

Description	Response type	Example
Returned only when with_details=true. Membership fields are preserved. Removed iterations are excluded. An inaccessible iteration contains only id and is_accessible=false; event dates and authors remain available. Missing user relations are omitted, not returned as null.	Array of objects	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	Removal timestamp, or null when no removal is recorded. Null does not imply that the iteration is still active.
removed_by_uid	string \| null	UID of the user who removed the card, or null when no removal author is recorded.
sort_order	number	Sort order of the card within the iteration
created	string	Creation timestamp
updated	string	Last update timestamp
iteration	object Schema	Iteration metadata filtered by access to its space.
addedBy	object Schema	User who added the card. Omitted if the related user cannot be found. The camelCase field name is part of the response contract.
removedBy	object Schema	User who removed the card. Omitted if no removal author is recorded or the related user cannot be found. The camelCase field name is part of the response contract.

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
The caller cannot access the card, or with_details=true was requested without the required iteration.read permission.		Response body does not exist

404

Description	Response type	Example
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

card_uid

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

Response

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