Перейти к содержимому

REST API: все операции ​

Операции сгруппированы по ресурсам клиента. Имена методов и типов совпадают с экспортами пакета. Для вложенных полей и точных TypeScript-типов используйте подсказки редактора. Ссылки ведут на первичную документацию Kaiten.

cards.iterate, documents.iterate и documentGroups.iterate обеспечивают автоматическую пагинацию соответствующих поисковых операций. Примеры — в руководстве по пагинации и типизированным фильтрам.

users.iterate и tags.iterate перебирают списки с пагинацией через смещение. Примеры — в разделе пользователей и тегов.

Маршруты здесь приведены в версии, указанной в документации Kaiten. REST-клиент использует /api/v1 по умолчанию; apiVersion: "latest" переключает префикс на /api/latest.

auditLogs · automations · boards · cardAllowedUsers · cardBlockerCategories · cardBlockerUsers · cardBlockers · cardChecklistItems · cardChecklists · cardChildren · cardComments · cardExternalLinks · cardFiles · cardMembers · cardServiceDeskExternalRecipients · cardSla · cardTags · cardTimeLogs · cardTypeTreeEntities · cardTypes · cards · checklistItems · checklists · columns · companyUsers · customDirectories · customDirectoryFields · customDirectoryRecords · customProperties · customPropertyCatalogValues · customPropertyCollectiveScoreValues · customPropertyCollectiveVoteValues · customPropertySelectValues · customPropertyTreeEntities · documentGroups · documentSchemas · documents · groupAdmins · groupEntities · groupUsers · groups · iterations · lanes · restrictedAccessCardFiles · restrictedAccessCommentFiles · restrictedAccessCustomPropertyFiles · serviceDeskServices · spaceBoards · spaceTemplateChecklistItems · spaceTemplateChecklist · spaceUsers · spaces · sprints · subcolumn · tags · timesheet · treeEntities · treeEntityRoles · userRoles · users

auditLogs ​

retrieveAuditLogEvents ​

client.auditLogs.retrieveAuditLogEvents · GET /api/latest/audit-logs

Retrieve audit log events. Документация Kaiten.

...args: AuditLogsRetrieveAuditLogEventsParams

ts
declare const retrieveAuditLogEvents: (
  query?: AuditLogsRetrieveAuditLogEventsQuery,
  options?: OperationOptions,
) => Promise<AuditLogsRetrieveAuditLogEventsResponse>;

Параметры пути

нет.

Параметры запроса

ПолеТипОбязательность
fromstringНеобязательно
tostringНеобязательно
author_idintegerНеобязательно
author_uidstringНеобязательно
categoriesstringНеобязательно
actionsstringНеобязательно
idstringНеобязательно
limitintegerНеобязательно
offsetintegerНеобязательно

Ответ: Массив. Поля: id, app_name, company_uid, author_id, author_uid, author_username, author_remote_address, author, category, action, message, details, created.

automations ​

createAutomation ​

client.automations.createAutomation · POST /api/latest/spaces/{space_id}/automations

Create automation. Документация Kaiten.

...args: AutomationsCreateAutomationParams

ts
declare const createAutomation: (
  spaceId: number,
  body: AutomationsCreateAutomationBody,
  options?: OperationOptions,
) => Promise<AutomationsCreateAutomationResponse>;

Параметры пути

ПолеТипОбязательность
space_idintegerОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
typeon_action | on_date | on_demandОбязательно
namestringНеобязательно
triggerAutomationTriggerНеобязательно
conditionsAutomationConditionGroupНеобязательно
actionsarray of AutomationActionОбязательно

Ответ: Объект. Поля: created, updated, id, company_id, space_uid, updater_id, name, status, trigger, actions, conditions, type, sort_order.

deleteAutomation ​

client.automations.deleteAutomation · DELETE /api/latest/spaces/{space_id}/automations/{automation_uid}

Delete automation. Документация Kaiten.

...args: AutomationsDeleteAutomationParams

ts
declare const deleteAutomation: (
  spaceId: number,
  automationUid: string,
  options?: OperationOptions,
) => Promise<AutomationsDeleteAutomationResponse>;

Параметры пути

ПолеТипОбязательность
space_idintegerОбязательно
automation_uidstringОбязательно

Параметры запроса

нет.

Ответ: Объект. Поля: message.

getListOfAutomations ​

client.automations.getListOfAutomations · GET /api/latest/spaces/{space_id}/automations

Get list of automations. Документация Kaiten.

...args: AutomationsGetListOfAutomationsParams

ts
declare const getListOfAutomations: (
  spaceId: number,
  options?: OperationOptions,
) => Promise<AutomationsGetListOfAutomationsResponse>;

Параметры пути

ПолеТипОбязательность
space_idintegerОбязательно

Параметры запроса

нет.

Ответ: Массив. Поля: created, updated, id, company_id, space_uid, updater_id, name, status, trigger, actions, conditions, type, sort_order.

updateAutomation ​

client.automations.updateAutomation · PATCH /api/latest/spaces/{space_id}/automations/{automation_uid}

Update automation. Документация Kaiten.

...args: AutomationsUpdateAutomationParams

ts
declare const updateAutomation: (
  spaceId: number,
  automationUid: string,
  body: AutomationsUpdateAutomationBody,
  options?: OperationOptions,
) => Promise<AutomationsUpdateAutomationResponse>;

Параметры пути

ПолеТипОбязательность
space_idintegerОбязательно
automation_uidstringОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
typeon_action | on_date | on_demandНеобязательно
namestringНеобязательно
triggerAutomationTriggerНеобязательно
conditionsAutomationConditionGroupНеобязательно
actionsarray of AutomationActionНеобязательно

Ответ: Объект. Поля: created, updated, id, company_id, space_uid, updater_id, name, status, trigger, actions, conditions, type, sort_order.

boards ​

getBoard ​

client.boards.getBoard · GET /api/latest/boards/{id}

Get board. Документация Kaiten.

...args: BoardsGetBoardParams

ts
declare const getBoard: (
  boardId: number,
  options?: OperationOptions,
) => Promise<BoardsGetBoardResponse>;

Параметры пути

ПолеТипОбязательность
idintegerОбязательно

Параметры запроса

нет.

Ответ: Объект. Поля: created, updated, id, title, cell_wip_limits, external_id, default_card_type_id, description, email_key, move_parents_to_done, default_tags, first_image_is_cover, reset_lane_spent_time, backward_moves_enabled, hide_done_policies, hide_done_policies_in_done_column, automove_cards, auto_assign_enabled, card_properties, columns, lanes, cards.

cardAllowedUsers ​

retrieveUsersList ​

client.cardAllowedUsers.retrieveUsersList · GET /api/latest/cards/{card_id}/allowed-users

Retrieve users list. Документация Kaiten.

...args: CardAllowedUsersRetrieveUsersListParams

ts
declare const retrieveUsersList: (
  cardId: number,
  query?: CardAllowedUsersRetrieveUsersListQuery,
  options?: OperationOptions,
) => Promise<CardAllowedUsersRetrieveUsersListResponse>;

Параметры пути

ПолеТипОбязательность
card_idintegerОбязательно

Параметры запроса

ПолеТипОбязательность
typeenumНеобязательно
searchstringНеобязательно
orderBystringНеобязательно
roleintegerНеобязательно
limitintegerНеобязательно
offsetintegerНеобязательно

Ответ: Массив. Поля: id, full_name, email, username, avatar_initials_url, avatar_uploaded_url, initials, avatar_type, lng, timezone, theme, created, updated, activated, ui_version.

cardBlockerCategories ​

addBlockerCategory ​

client.cardBlockerCategories.addBlockerCategory · POST /api/latest/blockers/{blocker_id}/categories

Add blocker category. Документация Kaiten.

...args: CardBlockerCategoriesAddBlockerCategoryParams

ts
declare const addBlockerCategory: (
  blockerId: number,
  name: string,
  options?: OperationOptions,
) => Promise<CardBlockerCategoriesAddBlockerCategoryResponse>;

Параметры пути

ПолеТипОбязательность
blocker_idintegerОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
namestringОбязательно

Ответ: Объект. Поля: uid, name, color.

removeCategory ​

client.cardBlockerCategories.removeCategory · DELETE /api/latest/blockers/{blocker_id}/categories/{category_uuid}

Remove category. Документация Kaiten.

...args: CardBlockerCategoriesRemoveCategoryParams

ts
declare const removeCategory: (
  blockerId: number,
  categoryUuid: string,
  options?: OperationOptions,
) => Promise<CardBlockerCategoriesRemoveCategoryResponse>;

Параметры пути

ПолеТипОбязательность
blocker_idintegerОбязательно
category_uuidstringОбязательно

Параметры запроса

нет.

Ответ: Объект. Поля: uid.

retrieveListOfCategories ​

client.cardBlockerCategories.retrieveListOfCategories · GET /api/latest/categories

Retrieve list of categories. Документация Kaiten.

...args: CardBlockerCategoriesRetrieveListOfCategoriesParams

ts
declare const retrieveListOfCategories: (
  options?: OperationOptions,
) => Promise<CardBlockerCategoriesRetrieveListOfCategoriesResponse>;

Параметры пути

нет.

Параметры запроса

нет.

Ответ: Массив. Поля: uid, name, color.

cardBlockerUsers ​

addUserToTheCardBlocker ​

client.cardBlockerUsers.addUserToTheCardBlocker · POST /api/latest/blockers/{blocker_id}/users

Add user to the card blocker. Документация Kaiten.

...args: CardBlockerUsersAddUserToTheCardBlockerParams

ts
declare const addUserToTheCardBlocker: (
  blockerId: number,
  userId: number,
  options?: OperationOptions,
) => Promise<CardBlockerUsersAddUserToTheCardBlockerResponse>;

Параметры пути

ПолеТипОбязательность
blocker_idintegerОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
user_idintegerОбязательно

Ответ: Объект. Поля: id, uid, full_name, email, username, avatar_initials_url, avatar_uploaded_url, initials, avatar_type, lng, timezone, theme, created, updated, activated, ui_version, virtual, email_blocked, email_blocked_reason, delete_requested_at.

removeUser ​

client.cardBlockerUsers.removeUser · DELETE /api/latest/blockers/{blocker_id}/users/{user_id}

Remove user. Документация Kaiten.

...args: CardBlockerUsersRemoveUserParams

ts
declare const removeUser: (
  blockerId: number,
  userId: number,
  options?: OperationOptions,
) => Promise<CardBlockerUsersRemoveUserResponse>;

Параметры пути

ПолеТипОбязательность
blocker_idintegerОбязательно
user_idintegerОбязательно

Параметры запроса

нет.

Ответ: Объект. Поля: id.

retrieveBlockersCardsListOnCurrentUser ​

client.cardBlockerUsers.retrieveBlockersCardsListOnCurrentUser · GET /api/latest/users/current/blockers

Retrieve blockers cards list on current user. Документация Kaiten.

...args: CardBlockerUsersRetrieveBlockersCardsListOnCurrentUserParams

ts
declare const retrieveBlockersCardsListOnCurrentUser: (
  options?: OperationOptions,
) => Promise<CardBlockerUsersRetrieveBlockersCardsListOnCurrentUserResponse>;

Параметры пути

нет.

Параметры запроса

нет.

Ответ: Объект. Поля: blocked_cards, summary.

retrieveListOfUsers ​

client.cardBlockerUsers.retrieveListOfUsers · GET /api/latest/blockers/{blocker_id}/users

Retrieve list of users. Документация Kaiten.

...args: CardBlockerUsersRetrieveListOfUsersParams

ts
declare const retrieveListOfUsers: (
  blockerId: number,
  options?: OperationOptions,
) => Promise<CardBlockerUsersRetrieveListOfUsersResponse>;

Параметры пути

ПолеТипОбязательность
blocker_idintegerОбязательно

Параметры запроса

нет.

Ответ: Массив. Поля: created, updated, id, full_name, email, username, activated, show_tour, avatar_initials_url, initials, avatar_type, avatar_uploaded_url, lng, timezone, chat_enabled, theme, sd_telegram_id, news_subscription, ui_version, uid, virtual, email_blocked, email_blocked_reason, delete_requested_at, delete_confirmation_sent_at, eula_accepted_at, terms_of_service_accepted_at, privacy_policy_accepted_at, block_uid, user_uid.

cardBlockers ​

blockCard ​

client.cardBlockers.blockCard · POST /api/latest/cards/{card_id}/blockers

Block card. Документация Kaiten.

...args: CardBlockersBlockCardParams

ts
declare const blockCard: (
  cardId: number,
  body: CardBlockersBlockCardBody,
  options?: OperationOptions,
) => Promise<CardBlockersBlockCardResponse>;

Параметры пути

ПолеТипОбязательность
card_idintegerОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
reasonstringНеобязательно
blocker_card_idintegerНеобязательно

Ответ: Объект. Поля: created, updated, id, reason, card_id, blocker_id, blocker_card_id, blocker_card_title, released, released_by_id, due_date, due_date_time_present, blocked_card, blocker, card.

deleteCardBlockers ​

client.cardBlockers.deleteCardBlockers · DELETE /api/latest/cards/{card_id}/blockers/{id}

Delete card blockers. Документация Kaiten.

...args: CardBlockersDeleteCardBlockersParams

ts
declare const deleteCardBlockers: (
  cardId: number,
  blockerId: number,
  options?: OperationOptions,
) => Promise<CardBlockersDeleteCardBlockersResponse>;

Параметры пути

ПолеТипОбязательность
card_idintegerОбязательно
idintegerОбязательно

Параметры запроса

нет.

Ответ: Объект. Поля: created, updated, id, reason, card_id, blocker_id, blocker_card_id, blocker_card_title, released, released_by_id, due_date, due_date_time_present, blocked_card, card.

retrieveCardBlockersList ​

client.cardBlockers.retrieveCardBlockersList · GET /api/latest/cards/{card_id}/blockers

Retrieve card blockers list. Документация Kaiten.

...args: CardBlockersRetrieveCardBlockersListParams

ts
declare const retrieveCardBlockersList: (
  cardId: number,
  options?: OperationOptions,
) => Promise<CardBlockersRetrieveCardBlockersListResponse>;

Параметры пути

ПолеТипОбязательность
card_idintegerОбязательно

Параметры запроса

нет.

Ответ: Массив. Поля: created, updated, id, reason, card_id, blocker_id, blocker_card_id, blocker_card_title, released, released_by_id, due_date, due_date_time_present, blocked_card, blocker, card.

updateCardBlockers ​

client.cardBlockers.updateCardBlockers · PATCH /api/latest/cards/{card_id}/blockers/{id}

Update card blockers. Документация Kaiten.

...args: CardBlockersUpdateCardBlockersParams

ts
declare const updateCardBlockers: (
  cardId: number,
  blockerId: number,
  body: CardBlockersUpdateCardBlockersBody,
  options?: OperationOptions,
) => Promise<CardBlockersUpdateCardBlockersResponse>;

Параметры пути

ПолеТипОбязательность
card_idintegerОбязательно
idintegerОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
reasonstringНеобязательно
blocker_card_idintegerНеобязательно
due_datestring | nullНеобязательно
due_date_time_presentboolean | nullНеобязательно

Ответ: Объект. Поля: created, updated, id, reason, card_id, blocker_id, blocker_card_id, blocker_card_title, released, released_by_id, due_date, due_date_time_present.

cardChecklistItems ​

addItemToChecklist ​

client.cardChecklistItems.addItemToChecklist · POST /api/latest/cards/{card_id}/checklists/{checklist_id}/items

Add item to checklist. Документация Kaiten.

...args: CardChecklistItemsAddItemToChecklistParams

ts
declare const addItemToChecklist: (
  cardId: number,
  checklistId: number,
  body: CardChecklistItemsAddItemToChecklistBody,
  options?: OperationOptions,
) => Promise<CardChecklistItemsAddItemToChecklistResponse>;

Параметры пути

ПолеТипОбязательность
card_idintegerОбязательно
checklist_idintegerОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
textstringОбязательно
sort_ordernumberНеобязательно
checkedbooleanНеобязательно
due_datestring | nullНеобязательно
responsible_idintegerНеобязательно

Ответ: Объект. Поля: created, updated, id, text, sort_order, checked, checklist_id, checker_id, user_id, checked_at, responsible_id, deleted, due_date.

removeChecklistItem ​

client.cardChecklistItems.removeChecklistItem · DELETE /api/latest/cards/{card_id}/checklists/{checklist_id}/items/{id}

Remove checklist item. Документация Kaiten.

...args: CardChecklistItemsRemoveChecklistItemParams

ts
declare const removeChecklistItem: (
  cardId: number,
  checklistId: number,
  itemId: number,
  options?: OperationOptions,
) => Promise<CardChecklistItemsRemoveChecklistItemResponse>;

Параметры пути

ПолеТипОбязательность
card_idintegerОбязательно
checklist_idintegerОбязательно
idintegerОбязательно

Параметры запроса

нет.

Ответ: Объект. Поля: id.

updateChecklistItem ​

client.cardChecklistItems.updateChecklistItem · PATCH /api/latest/cards/{card_id}/checklists/{checklist_id}/items/{id}

Update checklist item. Документация Kaiten.

...args: CardChecklistItemsUpdateChecklistItemParams

ts
declare const updateChecklistItem: (
  cardId: number,
  checklistId: number,
  itemId: number,
  body: CardChecklistItemsUpdateChecklistItemBody,
  options?: OperationOptions,
) => Promise<CardChecklistItemsUpdateChecklistItemResponse>;

Параметры пути

ПолеТипОбязательность
card_idintegerОбязательно
checklist_idintegerОбязательно
idintegerОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
textstring | nullНеобязательно
sort_ordernumberНеобязательно
checklist_idintegerНеобязательно
checkedbooleanНеобязательно
due_datestring | nullНеобязательно
responsible_idnumber | nullНеобязательно

Ответ: Объект. Поля: created, updated, id, text, sort_order, checked, checklist_id, checker_id, user_id, checked_at, responsible_id, deleted, due_date.

cardChecklists ​

addChecklistToCard ​

client.cardChecklists.addChecklistToCard · POST /api/latest/cards/{card_id}/checklists

Add checklist to card. Документация Kaiten.

...args: CardChecklistsAddChecklistToCardParams

ts
declare const addChecklistToCard: (
  cardId: number,
  body: CardChecklistsAddChecklistToCardBody,
  options?: OperationOptions,
) => Promise<CardChecklistsAddChecklistToCardResponse>;

Параметры пути

ПолеТипОбязательность
card_idintegerОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
namestringНеобязательно
sort_ordernumberНеобязательно
items_source_checklist_idintegerНеобязательно
exclude_item_idsarray of integerНеобязательно
source_share_idintegerНеобязательно

Ответ: Объект. Поля: created, updated, id, name, policy_id, card_id, checklist_id, sort_order, deleted, items.

removeChecklistFromCard ​

client.cardChecklists.removeChecklistFromCard · DELETE /api/latest/cards/{card_id}/checklists/{id}

Remove checklist from card. Документация Kaiten.

...args: CardChecklistsRemoveChecklistFromCardParams

ts
declare const removeChecklistFromCard: (
  cardId: number,
  checklistId: number,
  options?: OperationOptions,
) => Promise<CardChecklistsRemoveChecklistFromCardResponse>;

Параметры пути

ПолеТипОбязательность
card_idintegerОбязательно
idintegerОбязательно

Параметры запроса

нет.

Ответ: Объект. Поля: id.

retrieveCardChecklist ​

client.cardChecklists.retrieveCardChecklist · GET /api/latest/cards/{card_id}/checklists/{id}

Retrieve card checklist. Документация Kaiten.

...args: CardChecklistsRetrieveCardChecklistParams

ts
declare const retrieveCardChecklist: (
  cardId: number,
  checklistId: number,
  options?: OperationOptions,
) => Promise<CardChecklistsRetrieveCardChecklistResponse>;

Параметры пути

ПолеТипОбязательность
card_idintegerОбязательно
idintegerОбязательно

Параметры запроса

нет.

Ответ: Объект. Поля: created, updated, id, uid, fts_version, name, policy_id, items.

updateChecklist ​

client.cardChecklists.updateChecklist · PATCH /api/latest/cards/{card_id}/checklists/{id}

Update checklist. Документация Kaiten.

...args: CardChecklistsUpdateChecklistParams

ts
declare const updateChecklist: (
  cardId: number,
  checklistId: number,
  body: CardChecklistsUpdateChecklistBody,
  options?: OperationOptions,
) => Promise<CardChecklistsUpdateChecklistResponse>;

Параметры пути

ПолеТипОбязательность
card_idintegerОбязательно
idintegerОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
namestringНеобязательно
sort_ordernumberНеобязательно
card_idintegerНеобязательно

Ответ: Объект. Поля: created, updated, id, name, policy_id.

cardChildren ​

addChildren ​

client.cardChildren.addChildren · POST /api/latest/cards/{card_id}/children

Add children. Документация Kaiten.

...args: CardChildrenAddChildrenParams

ts
declare const addChildren: (
  parentCardId: number,
  childCardId: number,
  options?: OperationOptions,
) => Promise<CardChildrenAddChildrenResponse>;

Параметры пути

ПолеТипОбязательность
card_idintegerОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
card_idintegerОбязательно

Ответ: Объект. Поля: id, created, updated, archived, title, asap, due_date, sort_order, fifo_order, state, condition, expires_later, parents_count, children_count, children_done, has_blocked_children, goals_total, goals_done, time_spent_sum, time_blocked_sum, children_number_properties_sum, calculated_planned_start, calculated_planned_end, parent_checklist_ids, children_ids, parents_ids, blocking_card, blocked, size, size_unit, size_text, due_date_time_present, board_id, column_id, lane_id, owner_id, type_id, version, updater_id, completed_on_time, completed_at, last_moved_at, lane_changed_at, column_changed_at, first_moved_to_in_progress_at, last_moved_to_done_at, sprint_id, external_id, comments_total, comment_last_added_at, properties, planned_start, planned_end, ignore_planned_dates_recalculation, service_id, sd_new_comment, public, share_settings, share_id, external_user_emails, description_filled, estimate_workload, has_access_to_space, path_data, space_id, type, owner.

removeChildren ​

client.cardChildren.removeChildren · DELETE /api/latest/cards/{card_id}/children/{id}

Remove children. Документация Kaiten.

...args: CardChildrenRemoveChildrenParams

ts
declare const removeChildren: (
  cardId: number,
  id: number,
  options?: OperationOptions,
) => Promise<CardChildrenRemoveChildrenResponse>;

Параметры пути

ПолеТипОбязательность
card_idintegerОбязательно
idintegerОбязательно

Параметры запроса

нет.

Ответ: Объект. Поля: id.

retrieveCardChildrenList ​

client.cardChildren.retrieveCardChildrenList · GET /api/latest/cards/{card_id}/children

Retrieve card children list. Документация Kaiten.

...args: CardChildrenRetrieveCardChildrenListParams

ts
declare const retrieveCardChildrenList: (
  cardId: number,
  options?: OperationOptions,
) => Promise<CardChildrenRetrieveCardChildrenListResponse>;

Параметры пути

ПолеТипОбязательность
card_idintegerОбязательно

Параметры запроса

нет.

Ответ: Массив. Поля: id, created, updated, archived, title, asap, due_date, sort_order, fifo_order, state, condition, expires_later, parents_count, children_count, children_done, has_blocked_children, goals_total, goals_done, time_spent_sum, time_blocked_sum, children_number_properties_sum, calculated_planned_start, calculated_planned_end, parent_checklist_ids, children_ids, parents_ids, blocking_card, blocked, size, size_unit, size_text, due_date_time_present, board_id, column_id, lane_id, owner_id, type_id, version, updater_id, completed_on_time, completed_at, last_moved_at, lane_changed_at, column_changed_at, first_moved_to_in_progress_at, last_moved_to_done_at, sprint_id, external_id, comments_total, comment_last_added_at, properties, planned_start, planned_end, ignore_planned_dates_recalculation, service_id, sd_new_comment, public, share_settings, share_id, external_user_emails, description_filled, estimate_workload, type, owner, board, lane, column, card_id, depends_on_card_id.

cardComments ​

addComment ​

client.cardComments.addComment · POST /api/latest/cards/{card_id}/comments

Add comment. Документация Kaiten.

...args: CardCommentsAddCommentParams

ts
declare const addComment: (
  cardId: number,
  body: CardCommentsAddCommentBody | FormData,
  options?: OperationOptions,
) => Promise<CardCommentsAddCommentResponse>;

Параметры пути

ПолеТипОбязательность
card_idintegerОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
textstringОбязательно
files[] Deprecatedarray of binary filesНеобязательно

Ответ: Объект. Поля: created, updated, id, uid, text, type, edited, card_id, author_id, email_addresses_to, deleted, internal, sd_external_recipients_cc, sd_description, notification_sent, attacments.

removeComment ​

client.cardComments.removeComment · DELETE /api/latest/cards/{card_id}/comments/{comment_id}

Remove comment. Документация Kaiten.

...args: CardCommentsRemoveCommentParams

ts
declare const removeComment: (
  cardId: number,
  commentId: number,
  options?: OperationOptions,
) => Promise<CardCommentsRemoveCommentResponse>;

Параметры пути

ПолеТипОбязательность
card_idintegerОбязательно
comment_idintegerОбязательно

Параметры запроса

нет.

Ответ: Объект. Поля: id.

retrieveCardComments ​

client.cardComments.retrieveCardComments · GET /api/latest/cards/{card_id}/comments

Retrieve card comments. Документация Kaiten.

...args: CardCommentsRetrieveCardCommentsParams

ts
declare const retrieveCardComments: (
  cardId: number,
  options?: OperationOptions,
) => Promise<CardCommentsRetrieveCardCommentsResponse>;

Параметры пути

ПолеТипОбязательность
card_idintegerОбязательно

Параметры запроса

нет.

Ответ: Массив. Поля: created, update, id, uid, text, edited, card_id, author_id, email_addresses_to, type, deleted, internal, sd_external_recipients_cc, notification_sent, sent_slack_messages_data, sd_description, author.

updateComment ​

client.cardComments.updateComment · PATCH /api/latest/cards/{card_id}/comments/{comment_id}

Update comment. Документация Kaiten.

...args: CardCommentsUpdateCommentParams

ts
declare const updateComment: (
  cardId: number,
  commentId: number,
  body: CardCommentsUpdateCommentBody | FormData,
  options?: OperationOptions,
) => Promise<CardCommentsUpdateCommentResponse>;

Параметры пути

ПолеТипОбязательность
card_idintegerОбязательно
comment_idintegerОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
textstringНеобязательно
files[] Deprecatedarray of binary filesНеобязательно

Ответ: Объект. Поля: created, updated, id, uid, text, type, edited, card_id, author_id, email_addresses_to, deleted, internal, sd_external_recipients_cc, sd_description, notification_sent, attacments.

client.cardExternalLinks.addExternalLink · POST /api/latest/cards/{card_id}/external-links

Add external link. Документация Kaiten.

...args: CardExternalLinksAddExternalLinkParams

ts
declare const addExternalLink: (
  cardId: number,
  url: string,
  description?: string | null,
  options?: OperationOptions,
) => Promise<CardExternalLinksAddExternalLinkResponse>;

Параметры пути

ПолеТипОбязательность
card_idintegerОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
urlstringОбязательно
descriptionstring | nullНеобязательно

Ответ: Объект. Поля: url, updated, created, id, description.

client.cardExternalLinks.removeExternalLink · DELETE /api/latest/cards/{card_id}/external-links/{id}

Remove external link. Документация Kaiten.

...args: CardExternalLinksRemoveExternalLinkParams

ts
declare const removeExternalLink: (
  cardId: number,
  id: number,
  options?: OperationOptions,
) => Promise<CardExternalLinksRemoveExternalLinkResponse>;

Параметры пути

ПолеТипОбязательность
card_idintegerОбязательно
idintegerОбязательно

Параметры запроса

нет.

Ответ: Объект. Поля: id.

client.cardExternalLinks.retrieveCardExternalLinks · GET /api/latest/cards/{card_id}/external-links

Retrieve card external links. Документация Kaiten.

...args: CardExternalLinksRetrieveCardExternalLinksParams

ts
declare const retrieveCardExternalLinks: (
  cardId: number,
  options?: OperationOptions,
) => Promise<CardExternalLinksRetrieveCardExternalLinksResponse>;

Параметры пути

ПолеТипОбязательность
card_idintegerОбязательно

Параметры запроса

нет.

Ответ: Массив. Поля: url, updated, created, id, description, card_id, external_link_id.

client.cardExternalLinks.updateExternalLink · PATCH /api/latest/cards/{card_id}/external-links/{id}

Update external link. Документация Kaiten.

...args: CardExternalLinksUpdateExternalLinkParams

ts
declare const updateExternalLink: (
  cardId: number,
  id: number,
  body: CardExternalLinksUpdateExternalLinkBody,
  options?: OperationOptions,
) => Promise<CardExternalLinksUpdateExternalLinkResponse>;

Параметры пути

ПолеТипОбязательность
card_idintegerОбязательно
idintegerОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
urlstringНеобязательно
descriptionstring | nullНеобязательно

Ответ: Объект. Поля: url, updated, created, id, description.

cardFiles ​

attachFileToCard ​

client.cardFiles.attachFileToCard · PUT /api/latest/cards/{card_id}/files

Attach file to card Deprecated. Документация Kaiten. Устаревшая операция.

...args: CardFilesAttachFileToCardParams

ts
declare const attachFileToCard: (
  cardId: number,
  file: Blob,
  options?: FileUploadOptions,
) => Promise<CardFilesAttachFileToCardResponse>;

Параметры пути

ПолеТипОбязательность
card_idintegerОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
filebinaryОбязательно

Ответ: Объект. Поля: author_id, card_cover, card_id, comment_id, created, deleted, external, id, mh_markup_id, mh_secret, name, size, sort_order, type, updated, url.

detachFileFromCard ​

client.cardFiles.detachFileFromCard · DELETE /api/latest/cards/{card_id}/files/{id}

Detach file from card. Документация Kaiten.

...args: CardFilesDetachFileFromCardParams

ts
declare const detachFileFromCard: (
  cardId: number,
  fileId: number,
  options?: OperationOptions,
) => Promise<CardFilesDetachFileFromCardResponse>;

Параметры пути

ПолеТипОбязательность
card_idintegerОбязательно
idintegerОбязательно

Параметры запроса

нет.

Ответ: Объект. Поля: id.

updateFile ​

client.cardFiles.updateFile · PATCH /api/latest/cards/{card_id}/files/{id}

Update file. Документация Kaiten.

...args: CardFilesUpdateFileParams

ts
declare const updateFile: (
  cardId: number,
  fileId: number,
  cardCover?: boolean,
  options?: OperationOptions,
) => Promise<CardFilesUpdateFileResponse>;

Параметры пути

ПолеТипОбязательность
card_idintegerОбязательно
idintegerОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
card_coverbooleanНеобязательно

Ответ: Объект

cardMembers ​

addMemberToCard ​

client.cardMembers.addMemberToCard · POST /api/latest/cards/{card_id}/members

Add member to card. Документация Kaiten.

...args: CardMembersAddMemberToCardParams

ts
declare const addMemberToCard: (
  cardId: number,
  userId: number,
  options?: OperationOptions,
) => Promise<CardMembersAddMemberToCardResponse>;

Параметры пути

ПолеТипОбязательность
card_idintegerОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
user_idintegerОбязательно

Ответ: Объект. Поля: id, full_name, email, username, avatar_initials_url, avatar_uploaded_url, initials, avatar_type, lng, timezone, theme, updated, type.

removeMemberFromCard ​

client.cardMembers.removeMemberFromCard · DELETE /api/latest/cards/{card_id}/members/{id}

Remove member from card. Документация Kaiten.

...args: CardMembersRemoveMemberFromCardParams

ts
declare const removeMemberFromCard: (
  cardId: number,
  memberId: number,
  options?: OperationOptions,
) => Promise<CardMembersRemoveMemberFromCardResponse>;

Параметры пути

ПолеТипОбязательность
card_idintegerОбязательно
idintegerОбязательно

Параметры запроса

нет.

Ответ: Объект. Поля: id.

retrieveListOfCardMembers ​

client.cardMembers.retrieveListOfCardMembers · GET /api/latest/cards/{card_id}/members

Retrieve list of card members. Документация Kaiten.

...args: CardMembersRetrieveListOfCardMembersParams

ts
declare const retrieveListOfCardMembers: (
  cardId: number,
  options?: OperationOptions,
) => Promise<CardMembersRetrieveListOfCardMembersResponse>;

Параметры пути

ПолеТипОбязательность
card_idintegerОбязательно

Параметры запроса

нет.

Ответ: Массив. Поля: id, full_name, email, username, avatar_initials_url, avatar_uploaded_url, initials, avatar_type, lng, timezone, theme, created, updated, activated, ui_version, virtual, card_id, user_id, type.

updateMemberRole ​

client.cardMembers.updateMemberRole · PATCH /api/latest/cards/{card_id}/members/{id}

Update member role. Документация Kaiten.

...args: CardMembersUpdateMemberRoleParams

ts
declare const updateMemberRole: (
  cardId: number,
  memberId: number,
  type: number,
  options?: OperationOptions,
) => Promise<CardMembersUpdateMemberRoleResponse>;

Параметры пути

ПолеТипОбязательность
card_idintegerОбязательно
idintegerОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
typeintegerОбязательно

Ответ: Объект. Поля: created, updated, card_id, user_id, type.

cardServiceDeskExternalRecipients ​

addNewRecipient ​

client.cardServiceDeskExternalRecipients.addNewRecipient · POST /api/latest/cards/{card_id}/sd-external-recipients

Add new recipient. Документация Kaiten.

...args: CardServiceDeskExternalRecipientsAddNewRecipientParams

ts
declare const addNewRecipient: (
  cardId: number,
  email: string,
  options?: OperationOptions,
) => Promise<CardServiceDeskExternalRecipientsAddNewRecipientResponse>;

Параметры пути

ПолеТипОбязательность
card_idintegerОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
emailstringОбязательно

Ответ: Объект. Поля: created, updated, card_id, user_id, email, unsubscribed, updater_id.

removeRecipient ​

client.cardServiceDeskExternalRecipients.removeRecipient · DELETE /api/latest/cards/{card_id}/sd-external-recipients/{email}

Remove recipient. Документация Kaiten.

...args: CardServiceDeskExternalRecipientsRemoveRecipientParams

ts
declare const removeRecipient: (
  cardId: number,
  email: string,
  options?: OperationOptions,
) => Promise<CardServiceDeskExternalRecipientsRemoveRecipientResponse>;

Параметры пути

ПолеТипОбязательность
card_idintegerОбязательно
emailstringОбязательно

Параметры запроса

нет.

Ответ: Объект. Поля: created, updated, card_id, user_id, email, unsubscribed, updater_id, company_id.

cardSla ​

retrieveCardSlaMeasurements ​

client.cardSla.retrieveCardSlaMeasurements · GET /api/latest/cards/{card_id}/sla-rules-measurements

Retrieve card SLA measurements. Документация Kaiten.

...args: CardSlaRetrieveCardSlaMeasurementsParams

ts
declare const retrieveCardSlaMeasurements: (
  cardId: number,
  options?: OperationOptions,
) => Promise<CardSlaRetrieveCardSlaMeasurementsResponse>;

Параметры пути

ПолеТипОбязательность
card_idintegerОбязательно

Параметры запроса

нет.

Ответ: Объект. Поля: calendars, rulesTimeData.

cardTags ​

addTag ​

client.cardTags.addTag · POST /api/latest/cards/{card_id}/tags

Add tag. Документация Kaiten.

...args: CardTagsAddTagParams

ts
declare const addTag: (
  cardId: number,
  name: string,
  options?: OperationOptions,
) => Promise<CardTagsAddTagResponse>;

Параметры пути

ПолеТипОбязательность
card_idintegerОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
namestringОбязательно

Ответ: Объект. Поля: created, updated, archived, id, name, company_id, color.

removeTagFromCard ​

client.cardTags.removeTagFromCard · DELETE /api/latest/cards/{card_id}/tags/{tag_id}

Remove tag from card. Документация Kaiten.

...args: CardTagsRemoveTagFromCardParams

ts
declare const removeTagFromCard: (
  cardId: number,
  tagId: number,
  options?: OperationOptions,
) => Promise<CardTagsRemoveTagFromCardResponse>;

Параметры пути

ПолеТипОбязательность
card_idintegerОбязательно
tag_idintegerОбязательно

Параметры запроса

нет.

Ответ: Объект. Поля: id.

rertrieveListOfTags ​

client.cardTags.rertrieveListOfTags · GET /api/latest/cards/{card_id}/tags

Rertrieve list of tags. Документация Kaiten.

...args: CardTagsRertrieveListOfTagsParams

ts
declare const rertrieveListOfTags: (
  cardId: number,
  options?: OperationOptions,
) => Promise<CardTagsRertrieveListOfTagsResponse>;

Параметры пути

ПолеТипОбязательность
card_idintegerОбязательно

Параметры запроса

нет.

Ответ: Массив. Поля: id, name, color, card_id, tag_id.

cardTimeLogs ​

addTimeLog ​

client.cardTimeLogs.addTimeLog · POST /api/latest/cards/{card_id}/time-logs

Add time log. Документация Kaiten.

...args: CardTimeLogsAddTimeLogParams

ts
declare const addTimeLog: (
  cardId: number,
  body: CardTimeLogsAddTimeLogBody,
  options?: OperationOptions,
) => Promise<CardTimeLogsAddTimeLogResponse>;

Параметры пути

ПолеТипОбязательность
card_idintegerОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
role_idintegerОбязательно
time_spentintegerОбязательно
for_datestringОбязательно
commentstringНеобязательно

Ответ: Объект. Поля: created, updated, id, card_id, user_id, role_id, author_id, updater_id, time_spent, for_date, comment.

getTimeLogs ​

client.cardTimeLogs.getTimeLogs · GET /api/latest/cards/{card_id}/time-logs

Get time logs. Документация Kaiten.

...args: CardTimeLogsGetTimeLogsParams

ts
declare const getTimeLogs: (
  cardId: number,
  forDate?: string,
  personal?: boolean,
  options?: OperationOptions,
) => Promise<CardTimeLogsGetTimeLogsResponse>;

Параметры пути

ПолеТипОбязательность
card_idintegerОбязательно

Параметры запроса

ПолеТипОбязательность
for_datestringНеобязательно
personalbooleanНеобязательно

Ответ: Массив. Поля: created, updated, id, card_id, user_id, role_id, author_id, updater_id, time_spent, for_date, comment, role, user, author.

removeTimeLog ​

client.cardTimeLogs.removeTimeLog · DELETE /api/latest/cards/{card_id}/time-logs/{id}

Remove time log. Документация Kaiten.

...args: CardTimeLogsRemoveTimeLogParams

ts
declare const removeTimeLog: (
  cardId: number,
  timeLogId: number,
  options?: OperationOptions,
) => Promise<CardTimeLogsRemoveTimeLogResponse>;

Параметры пути

ПолеТипОбязательность
card_idintegerОбязательно
idintegerОбязательно

Параметры запроса

нет.

Ответ: Объект. Поля: id.

updateLogRecord ​

client.cardTimeLogs.updateLogRecord · PATCH /api/latest/cards/{card_id}/time-logs/{id}

Update log record. Документация Kaiten.

...args: CardTimeLogsUpdateLogRecordParams

ts
declare const updateLogRecord: (
  cardId: number,
  timeLogId: number,
  body: CardTimeLogsUpdateLogRecordBody,
  options?: OperationOptions,
) => Promise<CardTimeLogsUpdateLogRecordResponse>;

Параметры пути

ПолеТипОбязательность
card_idintegerОбязательно
idintegerОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
role_idintegerНеобязательно
time_spentintegerНеобязательно
for_datestringНеобязательно
commentstringНеобязательно

Ответ: Объект. Поля: created, updated, id, card_id, user_id, role_id, author_id, updater_id, time_spent, for_date, comment.

cardTypeTreeEntities ​

addTreeEntityToCardType ​

client.cardTypeTreeEntities.addTreeEntityToCardType · POST /api/latest/card-types/{type_id}/tree-entities

Add tree entity to card type. Документация Kaiten.

...args: CardTypeTreeEntitiesAddTreeEntityToCardTypeParams

ts
declare const addTreeEntityToCardType: (
  typeId: number,
  treeEntityUid: string,
  options?: OperationOptions,
) => Promise<CardTypeTreeEntitiesAddTreeEntityToCardTypeResponse>;

Параметры пути

ПолеТипОбязательность
type_idintegerОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
tree_entity_uidstringОбязательно

Ответ: Объект. Поля: id.

deleteTreeEntityFromCardType ​

client.cardTypeTreeEntities.deleteTreeEntityFromCardType · DELETE /api/latest/card-types/{type_id}/tree-entities/{uid}

Delete tree entity from card type. Документация Kaiten.

...args: CardTypeTreeEntitiesDeleteTreeEntityFromCardTypeParams

ts
declare const deleteTreeEntityFromCardType: (
  typeId: number,
  uid: string,
  options?: OperationOptions,
) => Promise<void>;

Параметры пути

ПолеТипОбязательность
type_idintegerОбязательно
uidstringОбязательно

Параметры запроса

нет.

Ответ: Без тела

getListOfTypeTreeEntities ​

client.cardTypeTreeEntities.getListOfTypeTreeEntities · GET /api/latest/card-types/{type_id}/tree-entities

Get list of type tree entities. Документация Kaiten.

...args: CardTypeTreeEntitiesGetListOfTypeTreeEntitiesParams

ts
declare const getListOfTypeTreeEntities: (
  typeId: number,
  options?: OperationOptions,
) => Promise<CardTypeTreeEntitiesGetListOfTypeTreeEntitiesResponse>;

Параметры пути

ПолеТипОбязательность
type_idintegerОбязательно

Параметры запроса

нет.

Ответ: Массив. Поля: uid, title, company_id, sort_order, path, parent_entity_uid, entity_type, access, archived, for_everyone_access_role_id, protected.

cardTypes ​

createNewCardType ​

client.cardTypes.createNewCardType · POST /api/latest/card-types

Create new card type. Документация Kaiten.

...args: CardTypesCreateNewCardTypeParams

ts
declare const createNewCardType: (
  body: CardTypesCreateNewCardTypeBody,
  options?: OperationOptions,
) => Promise<CardTypesCreateNewCardTypeResponse>;

Параметры пути

нет.

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
letterstringОбязательно
namestringОбязательно
colorintegerОбязательно
propertiesobjectНеобязательно
card_propertiesarray of unknown | unknownНеобязательно
suggest_fieldsbooleanНеобязательно

Ответ: Объект. Поля: company_id, letter, name, color, updated, created, id, description_template, archived, properties, card_properties, suggest_fields.

getCardType ​

client.cardTypes.getCardType · GET /api/latest/card-types/{id}

Get card type. Документация Kaiten.

...args: CardTypesGetCardTypeParams

ts
declare const getCardType: (
  id: number,
  options?: OperationOptions,
) => Promise<CardTypesGetCardTypeResponse>;

Параметры пути

ПолеТипОбязательность
idintegerОбязательно

Параметры запроса

нет.

Ответ: Объект. Поля: company_id, letter, name, color, updated, created, id, description_template, archived, properties, card_properties, suggest_fields.

getListOfCardTypes ​

client.cardTypes.getListOfCardTypes · GET /api/latest/card-types

Get list of card types. Документация Kaiten.

...args: CardTypesGetListOfCardTypesParams

ts
declare const getListOfCardTypes: (
  limit?: number,
  offset?: number,
  options?: OperationOptions,
) => Promise<CardTypesGetListOfCardTypesResponse>;

Параметры пути

нет.

Параметры запроса

ПолеТипОбязательность
limitintegerНеобязательно
offsetintegerНеобязательно

Ответ: Массив. Поля: company_id, letter, name, color, updated, created, id, description_template, archived, properties, card_properties, suggest_fields.

removeCardType ​

client.cardTypes.removeCardType · DELETE /api/latest/card-types/{id}

Remove card type. Документация Kaiten.

...args: CardTypesRemoveCardTypeParams

ts
declare const removeCardType: (
  id: number,
  replaceTypeId: number,
  options?: OperationOptions,
) => Promise<CardTypesRemoveCardTypeResponse>;

Параметры пути

ПолеТипОбязательность
idintegerОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
replace_type_idnumberОбязательно

Ответ: Объект. Поля: company_id, letter, name, color, updated, created, id, description_template, archived, properties, card_properties, suggest_fields.

updateCardType ​

client.cardTypes.updateCardType · PATCH /api/latest/card-types/{id}

Update card type. Документация Kaiten.

...args: CardTypesUpdateCardTypeParams

ts
declare const updateCardType: (
  id: number,
  body: CardTypesUpdateCardTypeBody,
  options?: OperationOptions,
) => Promise<CardTypesUpdateCardTypeResponse>;

Параметры пути

ПолеТипОбязательность
idintegerОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
letterstringНеобязательно
namestringНеобязательно
colorintegerНеобязательно
propertiesobjectНеобязательно
card_propertiesarray of unknown | unknownНеобязательно
suggest_fieldsbooleanНеобязательно

Ответ: Объект. Поля: company_id, letter, name, color, updated, created, id, description_template, archived, properties, card_properties, suggest_fields.

cards ​

batchUpdateForCards ​

client.cards.batchUpdateForCards · PATCH /api/latest/cards

Batch update for cards. Документация Kaiten.

...args: CardsBatchUpdateForCardsParams

ts
declare const batchUpdateForCards: (
  body: CardsBatchUpdateForCardsBody,
  options?: OperationOptions,
) => Promise<CardsBatchUpdateForCardsResponse>;

Параметры пути

нет.

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
board_idintegerНеобязательно
column_idintegerНеобязательно
lane_idintegerНеобязательно
owner_idintegerНеобязательно
type_idintegerНеобязательно
condition1 | 2Необязательно
attributesunknown | unknown | unknown | unknown | unknown | unknownНеобязательно
order_byunknownНеобязательно

Ответ: Объект. Поля: id.

createNewCard ​

client.cards.createNewCard · POST /api/latest/cards

Create new card. Документация Kaiten.

...args: CardsCreateNewCardParams

ts
declare const createNewCard: (
  body: CardsCreateNewCardBody,
  options?: OperationOptions,
) => Promise<CardsCreateNewCardResponse>;

Параметры пути

нет.

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
titlenumber | stringОбязательно
board_idintegerОбязательно
asapbooleanНеобязательно
due_datestring | nullНеобязательно
due_date_time_presentbooleanНеобязательно
sort_ordernumberНеобязательно
descriptionnumber | string | nullНеобязательно
expires_laterbooleanНеобязательно
size_textnumber | string | nullНеобязательно
column_idintegerНеобязательно
lane_idintegerНеобязательно
owner_idintegerНеобязательно
responsible_idintegerНеобязательно
owner_emailstringНеобязательно
position1 | 2Необязательно
type_idintegerНеобязательно
service_idinteger | nullНеобязательно
external_idnumber | string | nullНеобязательно
text_format_type_id1 | 2 | 3Необязательно
propertiesobjectНеобязательно

Ответ: Объект. Поля: created, updated, archived, id, title, description, asap, due_date, sort_order, fifo_order, state, condition, expires_later, parents_count, children_count, children_done, goals_total, goals_done, time_spent_sum, time_blocked_sum, children_number_properties_sum, parent_checklist_ids, blocking_card, blocked, size, size_unit, size_text, due_date_time_present, board_id, column_id, lane_id, owner_id, type_id, version, updater_id, completed_on_time, completed_at, last_moved_at, lane_changed_at, column_changed_at, first_moved_to_in_progress_at, last_moved_to_done_at, sprint_id, external_id, service_id, comments_total, comment_last_added_at, properties, planned_start, planned_end, ignore_planned_dates_recalculation, counters_recalculated_at, sd_new_comment, public, share_settings, share_id, external_user_emails, description_filled, estimate_workload, owner, type, external_links, files, checklists.

deleteCard ​

client.cards.deleteCard · DELETE /api/latest/cards/{card_id}

Delete card. Документация Kaiten.

...args: CardsDeleteCardParams

ts
declare const deleteCard: (
  cardId: number,
  options?: OperationOptions,
) => Promise<CardsDeleteCardResponse>;

Параметры пути

ПолеТипОбязательность
card_idintegerОбязательно

Параметры запроса

нет.

Ответ: Объект. Поля: created, updated, archived, id, title, asap, due_date, due_date_time_present, expires_later, sort_order, description, state, condition, blocking_card, blocked, size, size_unit, size_text, board_id, column_id, lane_id, owner_id, type_id, version, updater_id, completed_on_time, completed_at, last_moved_at, lane_changed_at, column_changed_at, first_moved_to_in_progress_at, last_moved_to_done_at, planned_start, planned_end, ignore_planned_dates_recalculation, sprint_id, external_id, service_id, properties, public, share_id, share_settings, external_user_emails, tag_ids, estimate_workload, comments_total, comment_last_added_at, parents_count, children_count, children_done, goals_total, goals_done, time_spent_sum, time_blocked_sum, children_number_properties_sum, calculated_planned_start, calculated_planned_end, description_filled, has_blocked_children, parent_checklist_ids, children_ids, parents_ids, fifo_order, counters_recalculated_at, sd_new_comment, import_id, owner, members.

retrieveCard ​

client.cards.retrieveCard · GET /api/latest/cards/{card_id}

Retrieve card. Документация Kaiten.

...args: CardsRetrieveCardParams

ts
declare const retrieveCard: (
  cardId: number,
  brokenApi?: boolean,
  options?: OperationOptions,
) => Promise<CardsRetrieveCardResponse>;

Параметры пути

ПолеТипОбязательность
card_idintegerОбязательно

Параметры запроса

ПолеТипОбязательность
broken_apibooleanНеобязательно

Ответ: Объект. Поля: created, updated, archived, id, uid, title, asap, due_date, due_date_time_present, expires_later, sort_order, description, state, condition, blocking_card, blocked, size, size_unit, size_text, board_id, column_id, lane_id, owner_id, type_id, version, updater_id, completed_on_time, completed_at, last_moved_at, lane_changed_at, column_changed_at, first_moved_to_in_progress_at, last_moved_to_done_at, planned_start, planned_end, ignore_planned_dates_recalculation, sprint_id, external_id, service_id, properties, public, share_id, share_settings, external_user_emails, tag_ids, estimate_workload, comments_total, comment_last_added_at, parents_count, children_count, children_done, goals_total, goals_done, time_spent_sum, time_blocked_sum, children_number_properties_sum, calculated_planned_start, calculated_planned_end, description_filled, has_blocked_children, parent_checklist_ids, children_ids, parents_ids, fifo_order, counters_recalculated_at, sd_new_comment, import_id, board, lane, column, type, checklists, members, blockers, owner, slas, blocked_at, blocker_id, blocker, block_reason, children, parents, files, tags, external_links, cardRole, email.

retrieveCardBaselines ​

client.cards.retrieveCardBaselines · GET /api/latest/cards/{card_id}/baselines

Retrieve card baselines. Документация Kaiten.

...args: CardsRetrieveCardBaselinesParams

ts
declare const retrieveCardBaselines: (
  cardId: number,
  options?: OperationOptions,
) => Promise<CardsRetrieveCardBaselinesResponse>;

Параметры пути

ПолеТипОбязательность
card_idintegerОбязательно

Параметры запроса

нет.

Ответ: Массив. Поля: id, uid, baseline_id, planned_start, planned_end.

retrieveCardList ​

client.cards.retrieveCardList · GET /api/latest/cards

Параметры со списками через запятую принимают QueryList<T>: строку либо readonly-массив значений соответствующего типа. Примеры — в разделе типизированных фильтров карточек.

Retrieve card list. Документация Kaiten.

...args: CardsRetrieveCardListParams

ts
declare const retrieveCardList: {
  (
    query: CardsRetrieveCardListQuery & {version: 2},
    options?: OperationOptions,
  ): Promise<SearchResponseV2<CardsRetrieveCardListResponse>>;
  (
    query?: Omit<CardsRetrieveCardListQuery, 'version'> & {version?: 1},
    options?: OperationOptions,
  ): Promise<CardsRetrieveCardListResponse>;
  (
    query: CardsRetrieveCardListQuery | undefined,
    options?: OperationOptions,
  ): Promise<
    | CardsRetrieveCardListResponse
    | SearchResponseV2<CardsRetrieveCardListResponse>
  >;
};

При query.version: 2 возвращается SearchResponseV2<...> с полями result и position; без этого параметра возвращается массив.

Параметры пути

нет.

Параметры запроса

ПолеТипОбязательность
created_beforestringНеобязательно
created_afterstringНеобязательно
updated_beforestringНеобязательно
updated_afterstringНеобязательно
first_moved_in_progress_afterstringНеобязательно
first_moved_in_progress_beforestringНеобязательно
last_moved_to_done_at_afterstringНеобязательно
last_moved_to_done_at_beforestringНеобязательно
due_date_afterstringНеобязательно
due_date_beforestringНеобязательно
querystringНеобязательно
versionintegerНеобязательно
tagstringНеобязательно
tag_idsstringНеобязательно
type_idsstringНеобязательно
exclude_board_idsstringНеобязательно
exclude_lane_idsstringНеобязательно
exclude_column_idsstringНеобязательно
column_idsstringНеобязательно
member_idsstringНеобязательно
owner_idsstringНеобязательно
responsible_idsstringНеобязательно
statesstringНеобязательно
external_idstringНеобязательно
additional_card_fieldsstringНеобязательно
search_fieldsstringНеобязательно
space_idintegerНеобязательно
limitintegerНеобязательно
offsetintegerНеобязательно
start_positionstringНеобязательно
include_search_previewbooleanНеобязательно
order_space_idintegerНеобязательно
board_idintegerНеобязательно
column_idintegerНеобязательно
lane_idintegerНеобязательно
conditionintegerНеобязательно
type_idintegerНеобязательно
responsible_idintegerНеобязательно
owner_idintegerНеобязательно
archivedbooleanНеобязательно
asapbooleanНеобязательно
overduebooleanНеобязательно
done_on_timebooleanНеобязательно
with_due_datebooleanНеобязательно
filterstring / CardFilterНеобязательно
order_bystringНеобязательно
order_directionstringНеобязательно
is_requestbooleanНеобязательно
exclude_owner_idsstringНеобязательно
exclude_card_idsstringНеобязательно
organizations_idsstringНеобязательно
broken_apibooleanНеобязательно

Ответ: Массив. Поля: id, uid, created, updated, archived, title, asap, due_date, sort_order, fifo_order, state, condition, expires_later, parents_count, children_count, children_done, has_blocked_children, goals_total, goals_done, time_spent_sum, time_blocked_sum, children_number_properties_sum, calculated_planned_start, calculated_planned_end, parent_checklist_ids, children_ids, parents_ids, blocking_card, blocked, size, size_unit, size_text, due_date_time_present, board_id, column_id, lane_id, owner_id, type_id, version, updater_id, completed_on_time, completed_at, last_moved_at, lane_changed_at, column_changed_at, first_moved_to_in_progress_at, last_moved_to_done_at, sprint_id, external_id, comments_total, comment_last_added_at, properties, planned_start, planned_end, ignore_planned_dates_recalculation, service_id, sd_new_comment, public, share_settings, share_id, external_user_emails, description_filled, estimate_workload, owner, board, members, column, lane, type, path_data.

retrieveCardLocationHistory ​

client.cards.retrieveCardLocationHistory · GET /api/latest/cards/{card_id}/location-history

Retrieve card location history. Документация Kaiten.

...args: CardsRetrieveCardLocationHistoryParams

ts
declare const retrieveCardLocationHistory: (
  cardId: number,
  options?: OperationOptions,
) => Promise<CardsRetrieveCardLocationHistoryResponse>;

Параметры пути

ПолеТипОбязательность
card_idintegerОбязательно

Параметры запроса

нет.

Ответ: Массив. Поля: id, card_id, board_id, column_id, subcolumn_id, lane_id, sprint_id, author_id, author, condition, changed.

updateCard ​

client.cards.updateCard · PATCH /api/latest/cards/{card_id}

Update card. Документация Kaiten.

...args: CardsUpdateCardParams

ts
declare const updateCard: (
  cardId: number,
  body: CardsUpdateCardBody,
  options?: OperationOptions,
) => Promise<CardsUpdateCardResponse>;

Параметры пути

ПолеТипОбязательность
card_idintegerОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
titlenumber | stringНеобязательно
asapbooleanНеобязательно
due_datestring | nullНеобязательно
due_date_time_presentbooleanНеобязательно
sort_ordernumberНеобязательно
descriptionnumber | string | nullНеобязательно
expires_laterbooleanНеобязательно
size_textnumber | string | nullНеобязательно
board_idintegerНеобязательно
column_idintegerНеобязательно
lane_idintegerНеобязательно
owner_idintegerНеобязательно
type_idintegerНеобязательно
service_idinteger | nullНеобязательно
blockedbooleanНеобязательно
condition1 | 2Необязательно
external_idnumber | string | nullНеобязательно
text_format_type_id1 | 2 | 3Необязательно
sd_new_commentbooleanНеобязательно
owner_emailstringНеобязательно
prev_card_idintegerНеобязательно
estimate_workloadnumberНеобязательно
ignore_planned_dates_recalculationbooleanНеобязательно
propertiesobjectНеобязательно

Ответ: Объект. Поля: created, updated, archived, id, title, asap, due_date, due_date_time_present, expires_later, sort_order, description, state, condition, blocking_card, blocked, size, size_unit, size_text, board_id, column_id, lane_id, owner_id, type_id, version, updater_id, completed_on_time, completed_at, last_moved_at, lane_changed_at, column_changed_at, first_moved_to_in_progress_at, last_moved_to_done_at, planned_start, planned_end, ignore_planned_dates_recalculation, sprint_id, external_id, service_id, properties, public, share_id, share_settings, external_user_emails, tag_ids, estimate_workload, comments_total, comment_last_added_at, parents_count, children_count, children_done, goals_total, goals_done, time_spent_sum, time_blocked_sum, children_number_properties_sum, calculated_planned_start, calculated_planned_end, description_filled, has_blocked_children, parent_checklist_ids, children_ids, parents_ids, fifo_order, counters_recalculated_at, sd_new_comment, import_id, owner, members.

checklistItems ​

addItemToChecklist ​

client.checklistItems.addItemToChecklist · POST /api/latest/checklists/{checklist_id}/items

Add item to checklist. Документация Kaiten.

...args: ChecklistItemsAddItemToChecklistParams

ts
declare const addItemToChecklist: (
  checklistId: number,
  body: ChecklistItemsAddItemToChecklistBody,
  options?: OperationOptions,
) => Promise<ChecklistItemsAddItemToChecklistResponse>;

Параметры пути

ПолеТипОбязательность
checklist_idintegerОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
textstringОбязательно
sort_ordernumberНеобязательно
checkedbooleanНеобязательно
due_datestring | nullНеобязательно
responsible_idintegerНеобязательно

Ответ: Объект. Поля: created, updated, id, text, sort_order, checked, checklist_id, checker_id, user_id, checked_at, responsible_id, deleted, due_date.

removeChecklistItem ​

client.checklistItems.removeChecklistItem · DELETE /api/latest/checklists/{checklist_id}/items/{id}

Remove checklist item. Документация Kaiten.

...args: ChecklistItemsRemoveChecklistItemParams

ts
declare const removeChecklistItem: (
  checklistId: number,
  itemId: number,
  options?: OperationOptions,
) => Promise<ChecklistItemsRemoveChecklistItemResponse>;

Параметры пути

ПолеТипОбязательность
checklist_idintegerОбязательно
idintegerОбязательно

Параметры запроса

нет.

Ответ: Объект. Поля: id.

updateChecklistItem ​

client.checklistItems.updateChecklistItem · PATCH /api/latest/checklists/{checklist_id}/items/{id}

Update checklist item. Документация Kaiten.

...args: ChecklistItemsUpdateChecklistItemParams

ts
declare const updateChecklistItem: (
  checklistId: number,
  itemId: number,
  body: ChecklistItemsUpdateChecklistItemBody,
  options?: OperationOptions,
) => Promise<ChecklistItemsUpdateChecklistItemResponse>;

Параметры пути

ПолеТипОбязательность
checklist_idintegerОбязательно
idintegerОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
textstring | nullНеобязательно
sort_ordernumberНеобязательно
checklist_idintegerНеобязательно
checkedbooleanНеобязательно
due_datestring | nullНеобязательно
responsible_idnumber | nullНеобязательно

Ответ: Объект. Поля: created, updated, id, text, sort_order, checked, checklist_id, checker_id, user_id, checked_at, responsible_id, deleted, due_date.

checklists ​

retrieveCardsWithChecklist ​

client.checklists.retrieveCardsWithChecklist · GET /api/latest/checklists/{id}

Retrieve cards with checklist. Документация Kaiten.

...args: ChecklistsRetrieveCardsWithChecklistParams

ts
declare const retrieveCardsWithChecklist: (
  id: number,
  onlySharedCards: boolean,
  options?: OperationOptions,
) => Promise<ChecklistsRetrieveCardsWithChecklistResponse>;

Параметры пути

ПолеТипОбязательность
idintegerОбязательно

Параметры запроса

ПолеТипОбязательность
only_shared_cardsbooleanОбязательно

Ответ: Массив. Поля: created, updated, archived, id, title, asap, due_date, sort_order, description, state, expires_later, parents_count, children_count, children_done, goals_total, goals_done, parent_checklist_ids, parent_link_ids, blocked, size, size_unit, size_text, due_date_time_present, board_id, column_id, lane_id, owner_id, type_id, version, updater_id, completed_on_time, completed_at, project_id, milestone_id, fifo_order, blocking_card, sprint_id, condition, last_moved_at, external_id, lane_changed_at, column_changed_at, first_moved_to_in_progress_at, last_moved_to_done_at, service_id, has_blocked_children, comments_total, comment_last_added_at, children_ids, parents_ids, properties, planned_start, planned_end, ignore_planned_dates_recalculation, counters_recalculated_at, sd_new_comment, public, share_id, share_settings, sd_external_recipients, external_user_emails, time_spent_sum, calculated_planned_start, calculated_planned_end, time_blocked_sum, children_number_properties_sum, description_filled, import_id, tag_ids, has_access_to_space, path_data, space_id.

columns ​

createNewColumn ​

client.columns.createNewColumn · POST /api/latest/boards/{board_id}/columns

Create new column. Документация Kaiten.

...args: ColumnsCreateNewColumnParams

ts
declare const createNewColumn: (
  boardId: number,
  body: ColumnsCreateNewColumnBody,
  options?: OperationOptions,
) => Promise<ColumnsCreateNewColumnResponse>;

Параметры пути

ПолеТипОбязательность
board_idintegerОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
external_idnumber | string | nullНеобязательно
titlestringОбязательно
sort_ordernumberНеобязательно
type1 | 2 | 3Необязательно
last_moved_warning_after_daysintegerНеобязательно
last_moved_warning_after_hoursintegerНеобязательно
last_moved_warning_after_minutesintegerНеобязательно
wip_limitintegerНеобязательно
wip_limit_type1 | 2Необязательно
col_countintegerНеобязательно
archive_after_daysintegerНеобязательно
months_to_hide_cardsinteger | nullНеобязательно
card_hide_after_daysinteger | nullНеобязательно
rulesintegerНеобязательно

Ответ: Объект. Поля: created, updated, id, title, sort_order, col_count, wip_limit, type, rules, board_id, column_id, archive_after_days, wip_limit_type, external_id, default_tags, last_moved_warning_after_minutes, last_moved_warning_after_days, last_moved_warning_after_hours, months_to_hide_cards, card_hide_after_days.

getListOfColumns ​

client.columns.getListOfColumns · GET /api/latest/boards/{board_id}/columns

Get list of columns. Документация Kaiten.

...args: ColumnsGetListOfColumnsParams

ts
declare const getListOfColumns: (
  boardId: number,
  options?: OperationOptions,
) => Promise<ColumnsGetListOfColumnsResponse>;

Параметры пути

ПолеТипОбязательность
board_idintegerОбязательно

Параметры запроса

нет.

Ответ: Массив. Поля: created, updated, id, title, sort_order, col_count, wip_limit, wip_limit_type, type, rules, board_id, column_id, archive_after_days, last_moved_warning_after_minutes, last_moved_warning_after_days, last_moved_warning_after_hours, external_id, default_tags, months_to_hide_cards, card_hide_after_days, pause_sla, subcolumns.

removeColumn ​

client.columns.removeColumn · DELETE /api/latest/boards/{board_id}/columns/{id}

Remove column. Документация Kaiten.

...args: ColumnsRemoveColumnParams

ts
declare const removeColumn: (
  boardId: number,
  columnId: number,
  force?: boolean,
  options?: OperationOptions,
) => Promise<ColumnsRemoveColumnResponse>;

Параметры пути

ПолеТипОбязательность
board_idintegerОбязательно
idintegerОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
forcebooleanНеобязательно

Ответ: Объект. Поля: id.

updateColumn ​

client.columns.updateColumn · PATCH /api/latest/boards/{board_id}/columns/{id}

Update column. Документация Kaiten.

...args: ColumnsUpdateColumnParams

ts
declare const updateColumn: (
  boardId: number,
  columnId: number,
  body: ColumnsUpdateColumnBody,
  options?: OperationOptions,
) => Promise<ColumnsUpdateColumnResponse>;

Параметры пути

ПолеТипОбязательность
board_idintegerОбязательно
idintegerОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
external_idnumber | string | nullНеобязательно
titlestringНеобязательно
sort_ordernumberНеобязательно
type1 | 2 | 3Необязательно
wip_limitinteger | nullНеобязательно
wip_limit_type1 | 2Необязательно
last_moved_warning_after_daysintegerНеобязательно
last_moved_warning_after_hoursintegerНеобязательно
last_moved_warning_after_minutesintegerНеобязательно
col_countintegerНеобязательно
archive_after_daysintegerНеобязательно
months_to_hide_cardsinteger | nullНеобязательно
card_hide_after_daysinteger | nullНеобязательно
rulesintegerНеобязательно
default_tagsstring | nullНеобязательно
prev_column_idinteger | nullНеобязательно
next_column_idinteger | nullНеобязательно
pause_slabooleanНеобязательно

Ответ: Объект. Поля: created, updated, id, title, sort_order, col_count, wip_limit, type, rules, board_id, column_id, archive_after_days, wip_limit_type, external_id, default_tags, last_moved_warning_after_minutes, last_moved_warning_after_days, last_moved_warning_after_hours, months_to_hide_cards, card_hide_after_days.

companyUsers ​

getListOfUsers ​

client.companyUsers.getListOfUsers · GET /api/latest/company/users

Get list of users. Документация Kaiten.

...args: CompanyUsersGetListOfUsersParams

ts
declare const getListOfUsers: (
  query?: CompanyUsersGetListOfUsersQuery,
  options?: OperationOptions,
) => Promise<CompanyUsersGetListOfUsersResponse>;

Параметры пути

нет.

Параметры запроса

ПолеТипОбязательность
invitesOnlybooleanНеобязательно
withTransferAccessStatusbooleanНеобязательно
for_members_sectionbooleanНеобязательно
owner_onlybooleanНеобязательно
only_paidbooleanНеобязательно
only_records_countbooleanНеобязательно
only_virtualbooleanНеобязательно
offsetintegerНеобязательно
limitintegerНеобязательно
querystringНеобязательно
access_type_permissionsstringНеобязательно
sd_access_typestringНеобязательно
take_licencestringНеобязательно
temporarily_inactive_statusstringНеобязательно
group_idsarrayНеобязательно
permissionsarrayНеобязательно

Ответ: Массив. Поля: id, uid, full_name, email, username, avatar_initials_url, avatar_uploaded_url, initials, avatar_type, lng, timezone, theme, created, updated, activated, ui_version, virtual, email_blocked, email_blocked_reason, delete_requested_at, permissions, own_permissions, spaces, groups, company_id, user_id, default_space_id, role, email_frequency, email_settings, slack_id, slack_settings, notification_settings, notification_enabled_channels, slack_private_channel_id, telegram_sd_bot_enabled, invite_last_sent_at, apps_permissions, external, last_request_date, last_request_method, work_time_settings, personal_settings, locked, take_licence.

removeVirtualUser ​

client.companyUsers.removeVirtualUser · DELETE /api/latest/company/users/{id}

Remove virtual user. Документация Kaiten.

...args: CompanyUsersRemoveVirtualUserParams

ts
declare const removeVirtualUser: (
  userId: number,
  options?: OperationOptions,
) => Promise<CompanyUsersRemoveVirtualUserResponse>;

Параметры пути

ПолеТипОбязательность
idintegerОбязательно

Параметры запроса

нет.

Ответ: Объект. Поля: id.

updateUser ​

client.companyUsers.updateUser · PATCH /api/latest/company/users/{id}

Update user. Документация Kaiten.

...args: CompanyUsersUpdateUserParams

ts
declare const updateUser: (
  userId: number,
  appsPermissions?: number,
  temporarilyInactive?: boolean,
  options?: OperationOptions,
) => Promise<CompanyUsersUpdateUserResponse>;

Параметры пути

ПолеТипОбязательность
idintegerОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
apps_permissionsintegerНеобязательно
temporarily_inactivebooleanНеобязательно

Ответ: Объект. Поля: id, uid, full_name, email, username, avatar_initials_url, avatar_uploaded_url, initials, avatar_type, lng, timezone, theme, created, updated, activated, ui_version, virtual, email_blocked, email_blocked_reason, delete_requested_at, user_id, company_id, default_space_id, role, permissions, apps_permissions, email_frequency, email_settings, slack_id, slack_private_channel_id, slack_settings, telegram_sd_bot_enabled, external, notification_settings, work_time_settings, invite_last_sent_at, last_request_date, last_request_method, notification_enabled_channels, personal_settings, locked, temporarily_inactive.

customDirectories ​

createCustomDirectory ​

client.customDirectories.createCustomDirectory · POST /api/latest/company/custom-directories

Create custom directory. Документация Kaiten. Beta.

...args: CustomDirectoriesCreateCustomDirectoryParams

ts
declare const createCustomDirectory: (
  body: CustomDirectoriesCreateCustomDirectoryBody,
  options?: OperationOptions,
) => Promise<CustomDirectoriesCreateCustomDirectoryResponse>;

Параметры пути

нет.

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
namestringОбязательно
descriptionnull | stringНеобязательно
multi_selectbooleanНеобязательно
allow_editingbooleanНеобязательно
display_field_indexintegerНеобязательно
fieldsarray of objectНеобязательно

Ответ: Объект. Поля: id, name, description, condition, settings, author_uid, company_uid, created, updated, fields.

deleteCustomDirectory ​

client.customDirectories.deleteCustomDirectory · DELETE /api/latest/company/custom-directories/{directory_id}

Delete custom directory. Документация Kaiten. Beta.

...args: CustomDirectoriesDeleteCustomDirectoryParams

ts
declare const deleteCustomDirectory: (
  directoryId: string,
  options?: OperationOptions,
) => Promise<CustomDirectoriesDeleteCustomDirectoryResponse>;

Параметры пути

ПолеТипОбязательность
directory_idstringОбязательно

Параметры запроса

нет.

Ответ: Объект. Поля: id, name, condition, updated.

getCustomDirectory ​

client.customDirectories.getCustomDirectory · GET /api/latest/company/custom-directories/{directory_id}

Get custom directory. Документация Kaiten. Beta.

...args: CustomDirectoriesGetCustomDirectoryParams

ts
declare const getCustomDirectory: (
  directoryId: string,
  options?: OperationOptions,
) => Promise<CustomDirectoriesGetCustomDirectoryResponse>;

Параметры пути

ПолеТипОбязательность
directory_idstringОбязательно

Параметры запроса

нет.

Ответ: Объект. Поля: id, name, description, condition, settings, author_uid, company_uid, created, updated, author, fields.

getListOfCustomDirectories ​

client.customDirectories.getListOfCustomDirectories · GET /api/latest/company/custom-directories

Get list of custom directories. Документация Kaiten. Beta.

...args: CustomDirectoriesGetListOfCustomDirectoriesParams

ts
declare const getListOfCustomDirectories: (
  query?: CustomDirectoriesGetListOfCustomDirectoriesQuery,
  options?: OperationOptions,
) => Promise<CustomDirectoriesGetListOfCustomDirectoriesResponse>;

Параметры пути

нет.

Параметры запроса

ПолеТипОбязательность
include_fieldsbooleanНеобязательно
include_authorbooleanНеобязательно
include_records_countbooleanНеобязательно
limitnumberНеобязательно
offsetnumberНеобязательно
querystringНеобязательно
conditionsarray of stringsНеобязательно

Ответ: Массив. Поля: id, name, description, condition, settings, records_count, created, updated.

updateCustomDirectory ​

client.customDirectories.updateCustomDirectory · PATCH /api/latest/company/custom-directories/{directory_id}

Update custom directory. Документация Kaiten. Beta.

...args: CustomDirectoriesUpdateCustomDirectoryParams

ts
declare const updateCustomDirectory: (
  directoryId: string,
  body: CustomDirectoriesUpdateCustomDirectoryBody,
  options?: OperationOptions,
) => Promise<CustomDirectoriesUpdateCustomDirectoryResponse>;

Параметры пути

ПолеТипОбязательность
directory_idstringОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
namestringНеобязательно
descriptionnull | stringНеобязательно
conditionactive | inactive | removedНеобязательно
multi_selectbooleanНеобязательно
allow_editingbooleanНеобязательно
fieldsarray of objectНеобязательно

Ответ: Объект. Поля: id, name, description, condition, settings, author_uid, company_uid, created, updated, author, fields.

customDirectoryFields ​

createField ​

client.customDirectoryFields.createField · POST /api/latest/company/custom-directories/{directory_id}/fields

Create field. Документация Kaiten. Beta.

...args: CustomDirectoryFieldsCreateFieldParams

ts
declare const createField: (
  directoryId: string,
  body: CustomDirectoryFieldsCreateFieldBody,
  options?: OperationOptions,
) => Promise<CustomDirectoryFieldsCreateFieldResponse>;

Параметры пути

ПолеТипОбязательность
directory_idstringОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
namestringОбязательно
typestring | number | date | email | url | phone | checkbox | select | user | catalog | directory_link | fileОбязательно
sort_orderintegerНеобязательно
requiredbooleanНеобязательно
is_displaybooleanНеобязательно

Ответ: Объект. Поля: id, custom_directory_id, name, type, custom_property_uid, linked_directory_id, reverse_field_id, condition, required, is_display, sort_order, settings, author_uid, company_uid, created, updated.

deleteField ​

client.customDirectoryFields.deleteField · DELETE /api/latest/company/custom-directories/{directory_id}/fields/{field_id}

Delete field. Документация Kaiten. Beta.

...args: CustomDirectoryFieldsDeleteFieldParams

ts
declare const deleteField: (
  directoryId: string,
  fieldId: string,
  options?: OperationOptions,
) => Promise<CustomDirectoryFieldsDeleteFieldResponse>;

Параметры пути

ПолеТипОбязательность
directory_idstringОбязательно
field_idstringОбязательно

Параметры запроса

нет.

Ответ: Объект. Поля: id, custom_directory_id, name, type, condition, updated.

getField ​

client.customDirectoryFields.getField · GET /api/latest/company/custom-directories/{directory_id}/fields/{field_id}

Get field. Документация Kaiten. Beta.

...args: CustomDirectoryFieldsGetFieldParams

ts
declare const getField: (
  directoryId: string,
  fieldId: string,
  options?: OperationOptions,
) => Promise<CustomDirectoryFieldsGetFieldResponse>;

Параметры пути

ПолеТипОбязательность
directory_idstringОбязательно
field_idstringОбязательно

Параметры запроса

нет.

Ответ: Объект. Поля: id, custom_directory_id, name, type, custom_property_uid, linked_directory_id, reverse_field_id, condition, required, is_display, sort_order, settings, author_uid, company_uid, created, updated, author, linkedDirectory, customProperty.

getListOfFields ​

client.customDirectoryFields.getListOfFields · GET /api/latest/company/custom-directories/{directory_id}/fields

Get list of fields. Документация Kaiten. Beta.

...args: CustomDirectoryFieldsGetListOfFieldsParams

ts
declare const getListOfFields: (
  directoryId: string,
  includeAuthor?: boolean,
  conditions?: ('active' | 'inactive' | 'removed')[],
  options?: OperationOptions,
) => Promise<CustomDirectoryFieldsGetListOfFieldsResponse>;

Параметры пути

ПолеТипОбязательность
directory_idstringОбязательно

Параметры запроса

ПолеТипОбязательность
include_authorbooleanНеобязательно
conditionsarray of stringsНеобязательно

Ответ: Массив. Поля: id, custom_directory_id, name, type, required, is_display, sort_order, condition.

updateField ​

client.customDirectoryFields.updateField · PATCH /api/latest/company/custom-directories/{directory_id}/fields/{field_id}

Update field. Документация Kaiten. Beta.

...args: CustomDirectoryFieldsUpdateFieldParams

ts
declare const updateField: (
  directoryId: string,
  fieldId: string,
  body: CustomDirectoryFieldsUpdateFieldBody,
  options?: OperationOptions,
) => Promise<CustomDirectoryFieldsUpdateFieldResponse>;

Параметры пути

ПолеТипОбязательность
directory_idstringОбязательно
field_idstringОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
namestringНеобязательно
conditionactive | inactive | removedНеобязательно
sort_orderintegerНеобязательно
requiredbooleanНеобязательно
is_displaybooleanНеобязательно

Ответ: Объект. Поля: id, custom_directory_id, name, type, custom_property_uid, linked_directory_id, reverse_field_id, condition, required, is_display, sort_order, settings, author_uid, company_uid, created, updated.

customDirectoryRecords ​

createRecord ​

client.customDirectoryRecords.createRecord · POST /api/latest/company/custom-directories/{directory_id}/records

Create record. Документация Kaiten. Beta.

...args: CustomDirectoryRecordsCreateRecordParams

ts
declare const createRecord: (
  directoryId: string,
  body: CustomDirectoryRecordsCreateRecordBody,
  responseProfile?: string,
  options?: OperationOptions,
) => Promise<CustomDirectoryRecordsCreateRecordResponse>;

Параметры пути

ПолеТипОбязательность
directory_idstringОбязательно

Параметры запроса

ПолеТипОбязательность
response_profilestringНеобязательно

Тело запроса

ПолеТипОбязательность
valuesobjectОбязательно

Ответ: Объект. Поля: id, custom_directory_id, display_value, condition, author_uid, updater_uid, company_uid, created, updated, author, updater, values.

deleteRecord ​

client.customDirectoryRecords.deleteRecord · DELETE /api/latest/company/custom-directories/{directory_id}/records/{record_id}

Delete record. Документация Kaiten. Beta.

...args: CustomDirectoryRecordsDeleteRecordParams

ts
declare const deleteRecord: (
  directoryId: string,
  recordId: string,
  options?: OperationOptions,
) => Promise<CustomDirectoryRecordsDeleteRecordResponse>;

Параметры пути

ПолеТипОбязательность
directory_idstringОбязательно
record_idstringОбязательно

Параметры запроса

нет.

Ответ: Объект. Поля: id, custom_directory_id, condition, updated.

getCardsLinkedToRecord ​

client.customDirectoryRecords.getCardsLinkedToRecord · GET /api/latest/company/custom-directories/{directory_id}/records/{record_id}/cards

Get cards linked to record. Документация Kaiten. Beta.

...args: CustomDirectoryRecordsGetCardsLinkedToRecordParams

ts
declare const getCardsLinkedToRecord: (
  directoryId: string,
  recordId: string,
  query?: CustomDirectoryRecordsGetCardsLinkedToRecordQuery,
  options?: OperationOptions,
) => Promise<CustomDirectoryRecordsGetCardsLinkedToRecordResponse>;

Параметры пути

ПолеТипОбязательность
directory_idstringОбязательно
record_idstringОбязательно

Параметры запроса

ПолеТипОбязательность
limitnumberНеобязательно
offsetnumberНеобязательно
filterstringНеобязательно

Ответ: Массив. Поля: id, uid, title.

getListOfRecords ​

client.customDirectoryRecords.getListOfRecords · GET /api/latest/company/custom-directories/{directory_id}/records

Get list of records. Документация Kaiten. Beta.

...args: CustomDirectoryRecordsGetListOfRecordsParams

ts
declare const getListOfRecords: (
  directoryId: string,
  query?: CustomDirectoryRecordsGetListOfRecordsQuery,
  options?: OperationOptions,
) => Promise<CustomDirectoryRecordsGetListOfRecordsResponse>;

Параметры пути

ПолеТипОбязательность
directory_idstringОбязательно

Параметры запроса

ПолеТипОбязательность
limitnumberНеобязательно
offsetnumberНеобязательно
querystringНеобязательно
profilestringНеобязательно
include_valuesbooleanНеобязательно
include_authorbooleanНеобязательно
conditionsarray of stringsНеобязательно
filtersobjectНеобязательно
filter_operatorstringНеобязательно

Ответ: Массив. Поля: id, custom_directory_id, display_value, condition, created, updated, values.

getRecord ​

client.customDirectoryRecords.getRecord · GET /api/latest/company/custom-directories/{directory_id}/records/{record_id}

Get record. Документация Kaiten. Beta.

...args: CustomDirectoryRecordsGetRecordParams

ts
declare const getRecord: (
  directoryId: string,
  recordId: string,
  profile?: string,
  options?: OperationOptions,
) => Promise<CustomDirectoryRecordsGetRecordResponse>;

Параметры пути

ПолеТипОбязательность
directory_idstringОбязательно
record_idstringОбязательно

Параметры запроса

ПолеТипОбязательность
profilestringНеобязательно

Ответ: Объект. Поля: id, custom_directory_id, display_value, condition, author_uid, updater_uid, company_uid, created, updated, author, updater, values.

updateRecord ​

client.customDirectoryRecords.updateRecord · PATCH /api/latest/company/custom-directories/{directory_id}/records/{record_id}

Update record. Документация Kaiten. Beta.

...args: CustomDirectoryRecordsUpdateRecordParams

ts
declare const updateRecord: (
  directoryId: string,
  recordId: string,
  body: CustomDirectoryRecordsUpdateRecordBody,
  responseProfile?: string,
  options?: OperationOptions,
) => Promise<CustomDirectoryRecordsUpdateRecordResponse>;

Параметры пути

ПолеТипОбязательность
directory_idstringОбязательно
record_idstringОбязательно

Параметры запроса

ПолеТипОбязательность
response_profilestringНеобязательно

Тело запроса

ПолеТипОбязательность
conditionactive | inactive | removedНеобязательно
valuesobjectНеобязательно

Ответ: Объект. Поля: id, custom_directory_id, display_value, condition, author_uid, updater_uid, company_uid, created, updated, author, updater, values.

customProperties ​

createNewProperty ​

client.customProperties.createNewProperty · POST /api/latest/company/custom-properties

Create new property. Документация Kaiten.

...args: CustomPropertiesCreateNewPropertyParams

ts
declare const createNewProperty: (
  body: CustomPropertiesCreateNewPropertyBody,
  options?: OperationOptions,
) => Promise<CustomPropertiesCreateNewPropertyResponse>;

Параметры пути

нет.

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
namestringНеобязательно
show_on_facadebooleanНеобязательно
multilinebooleanНеобязательно
vote_variantnull | rating | scale | emoji_setНеобязательно
typestring | number | date | email | phone | checkbox | select | formula | url | collective_score | vote | collective_vote | catalog | user | attachmentНеобязательно
values_typenull | number | textНеобязательно
colorfulboolean | nullНеобязательно
multi_selectboolean | nullНеобязательно
values_creatable_by_usersboolean | nullНеобязательно
dataunknown | unknown | unknown | unknown | unknownНеобязательно
formulastringНеобязательно
formula_source_cardobjectНеобязательно
colorinteger | nullНеобязательно
fields_settingsobjectНеобязательно

Ответ: Объект. Поля: name, type, show_on_facade, multiline, fields_settings, author_id, company_id, updated, created, id, condition, colorful, multi_select, values_creatable_by_users, data, values_type, vote_variant, protected, color, external_id.

getListOfProperties ​

client.customProperties.getListOfProperties · GET /api/latest/company/custom-properties

Get list of properties. Документация Kaiten.

...args: CustomPropertiesGetListOfPropertiesParams

ts
declare const getListOfProperties: (
  query?: CustomPropertiesGetListOfPropertiesQuery,
  options?: OperationOptions,
) => Promise<CustomPropertiesGetListOfPropertiesResponse>;

Параметры пути

нет.

Параметры запроса

ПолеТипОбязательность
include_valuesbooleanНеобязательно
include_authorbooleanНеобязательно
compactbooleanНеобязательно
load_by_idsbooleanНеобязательно
idsarrayНеобязательно
offsetintegerНеобязательно
limitintegerНеобязательно
order_bystringНеобязательно
order_directionstringНеобязательно
querystringНеобязательно

Ответ: Массив. Поля: created, updated, id, uid, type, name, condition, show_on_facade, multiline, author_id, company_id, colorful, multi_select, values_creatable_by_users, values_type, vote_variant, data, protected, fields_settings, color, external_id.

getProperty ​

client.customProperties.getProperty · GET /api/latest/company/custom-properties/{id}

Get property. Документация Kaiten.

...args: CustomPropertiesGetPropertyParams

ts
declare const getProperty: (
  propertyId: number,
  options?: OperationOptions,
) => Promise<CustomPropertiesGetPropertyResponse>;

Параметры пути

ПолеТипОбязательность
idintegerОбязательно

Параметры запроса

нет.

Ответ: Объект. Поля: created, updated, id, uid, type, name, condition, show_on_facade, multiline, author_id, company_id, colorful, multi_select, values_creatable_by_users, values_type, vote_variant, data, protected, fields_settings, color, external_id.

removeProperty ​

client.customProperties.removeProperty · DELETE /api/latest/company/custom-properties/{id}

Remove property. Документация Kaiten.

...args: CustomPropertiesRemovePropertyParams

ts
declare const removeProperty: (
  propertyId: number,
  options?: OperationOptions,
) => Promise<CustomPropertiesRemovePropertyResponse>;

Параметры пути

ПолеТипОбязательность
idintegerОбязательно

Параметры запроса

нет.

Ответ: Объект. Поля: created, updated, id, type, name, show_on_facade, author_id, company_id, condition, colorful, multi_select, values_creatable_by_users, data, multiline, values_type, vote_variant, protected, fields_settings, color.

updateProperty ​

client.customProperties.updateProperty · PATCH /api/latest/company/custom-properties/{id}

Update property. Документация Kaiten.

...args: CustomPropertiesUpdatePropertyParams

ts
declare const updateProperty: (
  propertyId: number,
  body: CustomPropertiesUpdatePropertyBody,
  options?: OperationOptions,
) => Promise<CustomPropertiesUpdatePropertyResponse>;

Параметры пути

ПолеТипОбязательность
idintegerОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
namestringНеобязательно
show_on_facadebooleanНеобязательно
multilinebooleanНеобязательно
conditionactive | inactiveНеобязательно
colorfulboolean | nullНеобязательно
multi_selectboolean | nullНеобязательно
values_creatable_by_usersboolean | nullНеобязательно
dataunknown | unknown | unknown | unknown | unknownНеобязательно
colorinteger | nullНеобязательно
fields_settingsobject | nullНеобязательно
is_used_as_progressbooleanНеобязательно

Ответ: Объект. Поля: created, updated, id, uid, type, name, condition, show_on_facade, multiline, author_id, company_id, colorful, multi_select, values_creatable_by_users, values_type, vote_variant, data, protected, fields_settings, color, external_id.

customPropertyCatalogValues ​

createNewCatalogValue ​

client.customPropertyCatalogValues.createNewCatalogValue · POST /api/latest/company/custom-properties/{property_id}/catalog-values

Create new catalog value. Документация Kaiten.

...args: CustomPropertyCatalogValuesCreateNewCatalogValueParams

ts
declare const createNewCatalogValue: (
  propertyId: number,
  body: CustomPropertyCatalogValuesCreateNewCatalogValueBody,
  options?: OperationOptions,
) => Promise<CustomPropertyCatalogValuesCreateNewCatalogValueResponse>;

Параметры пути

ПолеТипОбязательность
property_idintegerОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
valueobjectОбязательно

Ответ: Объект. Поля: created, updated, id, custom_property_id, value, name, author_id, updater_id, condition.

getCatalogValue ​

client.customPropertyCatalogValues.getCatalogValue · GET /api/latest/company/custom-properties/{property_id}/catalog-values/{id}

Get catalog value. Документация Kaiten.

...args: CustomPropertyCatalogValuesGetCatalogValueParams

ts
declare const getCatalogValue: (
  propertyId: number,
  valueId: number,
  options?: OperationOptions,
) => Promise<CustomPropertyCatalogValuesGetCatalogValueResponse>;

Параметры пути

ПолеТипОбязательность
property_idintegerОбязательно
idintegerОбязательно

Параметры запроса

нет.

Ответ: Объект. Поля: created, updated, id, custom_property_id, value, name, author_id, updater_id, condition.

getListOfCatalogValues ​

client.customPropertyCatalogValues.getListOfCatalogValues · GET /api/latest/company/custom-properties/{property_id}/catalog-values

Get list of catalog values. Документация Kaiten.

...args: CustomPropertyCatalogValuesGetListOfCatalogValuesParams

ts
declare const getListOfCatalogValues: (
  propertyId: number,
  query?: CustomPropertyCatalogValuesGetListOfCatalogValuesQuery,
  options?: OperationOptions,
) => Promise<CustomPropertyCatalogValuesGetListOfCatalogValuesResponse>;

Параметры пути

ПолеТипОбязательность
property_idintegerОбязательно

Параметры запроса

ПолеТипОбязательность
querystringНеобязательно
conditionsenumНеобязательно
limitintegerНеобязательно
offsetintegerНеобязательно

Ответ: Массив. Поля: created, updated, id, custom_property_id, value, name, author_id, updater_id, condition.

removeProperty ​

client.customPropertyCatalogValues.removeProperty · DELETE /api/latest/company/custom-properties/{property_id}/catalog-values/{id}

Remove property. Документация Kaiten.

...args: CustomPropertyCatalogValuesRemovePropertyParams

ts
declare const removeProperty: (
  propertyId: number,
  valueId: number,
  options?: OperationOptions,
) => Promise<CustomPropertyCatalogValuesRemovePropertyResponse>;

Параметры пути

ПолеТипОбязательность
property_idintegerОбязательно
idintegerОбязательно

Параметры запроса

нет.

Ответ: Объект. Поля: created, updated, id, custom_property_id, value, name, author_id, updater_id, condition.

updateCatalogValue ​

client.customPropertyCatalogValues.updateCatalogValue · PATCH /api/latest/company/custom-properties/{property_id}/catalog-values/{id}

Update catalog value. Документация Kaiten.

...args: CustomPropertyCatalogValuesUpdateCatalogValueParams

ts
declare const updateCatalogValue: (
  propertyId: number,
  valueId: number,
  body: CustomPropertyCatalogValuesUpdateCatalogValueBody,
  options?: OperationOptions,
) => Promise<CustomPropertyCatalogValuesUpdateCatalogValueResponse>;

Параметры пути

ПолеТипОбязательность
property_idintegerОбязательно
idintegerОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
conditionactive | inactiveНеобязательно
valueobjectНеобязательно
deletedbooleanНеобязательно

Ответ: Объект. Поля: created, updated, id, custom_property_id, value, name, author_id, updater_id, condition.

customPropertyCollectiveScoreValues ​

createNewScoreValue ​

client.customPropertyCollectiveScoreValues.createNewScoreValue · POST /api/latest/cards/{card_id}/custom-properties/{property_id}/collective-score-values

Create new score value. Документация Kaiten.

...args: CustomPropertyCollectiveScoreValuesCreateNewScoreValueParams

ts
declare const createNewScoreValue: (
  cardId: number,
  propertyId: number,
  value: string,
  options?: OperationOptions,
) => Promise<CustomPropertyCollectiveScoreValuesCreateNewScoreValueResponse>;

Параметры пути

ПолеТипОбязательность
card_idintegerОбязательно
property_idintegerОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
valuestringОбязательно

Ответ: Объект. Поля: created, updated, id, value, custom_property_id, author_id, updater_id, company_id, card_id.

getListOfScoreValues ​

client.customPropertyCollectiveScoreValues.getListOfScoreValues · GET /api/latest/cards/{card_id}/custom-properties/{property_id}/collective-score-values

Get list of score values. Документация Kaiten.

...args: CustomPropertyCollectiveScoreValuesGetListOfScoreValuesParams

ts
declare const getListOfScoreValues: (
  cardId: number,
  propertyId: number,
  options?: OperationOptions,
) => Promise<CustomPropertyCollectiveScoreValuesGetListOfScoreValuesResponse>;

Параметры пути

ПолеТипОбязательность
card_idintegerОбязательно
property_idintegerОбязательно

Параметры запроса

нет.

Ответ: Массив. Поля: id, custom_property_id, value, card_id, author_id, author.

updateScoreValue ​

client.customPropertyCollectiveScoreValues.updateScoreValue · PATCH /api/latest/cards/{card_id}/custom-properties/{property_id}/collective-score-values/{id}

Update score value. Документация Kaiten.

...args: CustomPropertyCollectiveScoreValuesUpdateScoreValueParams

ts
declare const updateScoreValue: (
  cardId: number,
  propertyId: number,
  valueId: number,
  value: string | null,
  options?: OperationOptions,
) => Promise<CustomPropertyCollectiveScoreValuesUpdateScoreValueResponse>;

Параметры пути

ПолеТипОбязательность
card_idintegerОбязательно
property_idintegerОбязательно
idintegerОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
valuestring | nullНеобязательно

Ответ: Объект. Поля: created, updated, id, value, custom_property_id, author_id, updater_id, company_id, card_id.

customPropertyCollectiveVoteValues ​

createNewVoteValue ​

client.customPropertyCollectiveVoteValues.createNewVoteValue · POST /api/latest/cards/{card_id}/custom-properties/{property_id}/collective-vote-values

Create new vote value. Документация Kaiten.

...args: CustomPropertyCollectiveVoteValuesCreateNewVoteValueParams

ts
declare const createNewVoteValue: (
  cardId: number,
  propertyId: number,
  body: CustomPropertyCollectiveVoteValuesCreateNewVoteValueBody,
  options?: OperationOptions,
) => Promise<CustomPropertyCollectiveVoteValuesCreateNewVoteValueResponse>;

Параметры пути

ПолеТипОбязательность
card_idintegerОбязательно
property_idintegerОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
emoji_votestringНеобязательно
number_voteintegerНеобязательно

Ответ: Объект. Поля: created, updated, id, number_vote, emoji_vote, custom_property_id, author_id, company_id, card_id.

getListOfVoteValues ​

client.customPropertyCollectiveVoteValues.getListOfVoteValues · GET /api/latest/cards/{card_id}/custom-properties/{property_id}/collective-vote-values

Get list of vote values. Документация Kaiten.

...args: CustomPropertyCollectiveVoteValuesGetListOfVoteValuesParams

ts
declare const getListOfVoteValues: (
  cardId: number,
  propertyId: number,
  options?: OperationOptions,
) => Promise<CustomPropertyCollectiveVoteValuesGetListOfVoteValuesResponse>;

Параметры пути

ПолеТипОбязательность
card_idintegerОбязательно
property_idintegerОбязательно

Параметры запроса

нет.

Ответ: Массив. Поля: id, custom_property_id, number_vote, emoji_vote, card_id, author_id, author.

removeVoteValue ​

client.customPropertyCollectiveVoteValues.removeVoteValue · DELETE /api/latest/cards/{card_id}/custom-properties/{property_id}/collective-vote-values/{id}

Remove vote value. Документация Kaiten.

...args: CustomPropertyCollectiveVoteValuesRemoveVoteValueParams

ts
declare const removeVoteValue: (
  cardId: number,
  propertyId: number,
  id: number,
  emojiVote: string,
  options?: OperationOptions,
) => Promise<CustomPropertyCollectiveVoteValuesRemoveVoteValueResponse>;

Параметры пути

ПолеТипОбязательность
card_idintegerОбязательно
property_idintegerОбязательно
idintegerОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
emoji_votestringНеобязательно

Ответ: Объект. Поля: id, custom_property_id, number_vote, emoji_vote, card_id, author_id.

updateVoteValue ​

client.customPropertyCollectiveVoteValues.updateVoteValue · PATCH /api/latest/cards/{card_id}/custom-properties/{property_id}/collective-vote-values/{id}

Update vote value. Документация Kaiten.

...args: CustomPropertyCollectiveVoteValuesUpdateVoteValueParams

ts
declare const updateVoteValue: (
  cardId: number,
  propertyId: number,
  id: number,
  numberVote?: number | null,
  options?: OperationOptions,
) => Promise<CustomPropertyCollectiveVoteValuesUpdateVoteValueResponse>;

Параметры пути

ПолеТипОбязательность
card_idintegerОбязательно
property_idintegerОбязательно
idintegerОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
number_votenumber | nullНеобязательно

Ответ: Объект. Поля: created, updated, id, number_vote, emoji_vote, custom_property_id, author_id, company_id, card_id.

customPropertySelectValues ​

createNewSelectValue ​

client.customPropertySelectValues.createNewSelectValue · POST /api/latest/company/custom-properties/{property_id}/select-values

Create new select value. Документация Kaiten.

...args: CustomPropertySelectValuesCreateNewSelectValueParams

ts
declare const createNewSelectValue: (
  propertyId: number,
  value: string,
  color?: number | null,
  options?: OperationOptions,
) => Promise<CustomPropertySelectValuesCreateNewSelectValueResponse>;

Параметры пути

ПолеТипОбязательность
property_idintegerОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
valuestringОбязательно
colorinteger | nullНеобязательно

Ответ: Объект. Поля: created, updated, id, custom_property_id, value, color, author_id, company_id, sort_order, external_id, condition.

getListOfSelectValues ​

client.customPropertySelectValues.getListOfSelectValues · GET /api/latest/company/custom-properties/{property_id}/select-values

Get list of select values. Документация Kaiten.

...args: CustomPropertySelectValuesGetListOfSelectValuesParams

ts
declare const getListOfSelectValues: (
  propertyId: number,
  query?: CustomPropertySelectValuesGetListOfSelectValuesQuery,
  options?: OperationOptions,
) => Promise<CustomPropertySelectValuesGetListOfSelectValuesResponse>;

Параметры пути

ПолеТипОбязательность
property_idintegerОбязательно

Параметры запроса

ПолеТипОбязательность
v2_select_searchbooleanНеобязательно
querystringНеобязательно
order_bystringНеобязательно
idsarrayНеобязательно
conditionsarrayНеобязательно
offsetintegerНеобязательно
limitintegerНеобязательно

Ответ: Массив. Поля: id, custom_property_id, value, color, sort_order, external_id, updated, condition.

getSelectValue ​

client.customPropertySelectValues.getSelectValue · GET /api/latest/company/custom-properties/{property_id}/select-values/{id}

Get select value. Документация Kaiten.

...args: CustomPropertySelectValuesGetSelectValueParams

ts
declare const getSelectValue: (
  propertyId: number,
  valueId: number,
  options?: OperationOptions,
) => Promise<CustomPropertySelectValuesGetSelectValueResponse>;

Параметры пути

ПолеТипОбязательность
property_idintegerОбязательно
idintegerОбязательно

Параметры запроса

нет.

Ответ: Объект. Поля: created, updated, id, custom_property_id, value, color, author_id, company_id, sort_order, external_id, condition.

removeProperty ​

client.customPropertySelectValues.removeProperty · DELETE /api/latest/company/custom-properties/{property_id}/select-values/{id}

Remove property. Документация Kaiten.

...args: CustomPropertySelectValuesRemovePropertyParams

ts
declare const removeProperty: (
  propertyId: number,
  valueId: number,
  options?: OperationOptions,
) => Promise<CustomPropertySelectValuesRemovePropertyResponse>;

Параметры пути

ПолеТипОбязательность
property_idintegerОбязательно
idintegerОбязательно

Параметры запроса

нет.

Ответ: Объект. Поля: created, updated, id, custom_property_id, value, color, author_id, company_id, sort_order, external_id, condition.

updateSelectValue ​

client.customPropertySelectValues.updateSelectValue · PATCH /api/latest/company/custom-properties/{property_id}/select-values/{id}

Update select value. Документация Kaiten.

...args: CustomPropertySelectValuesUpdateSelectValueParams

ts
declare const updateSelectValue: (
  propertyId: number,
  valueId: number,
  body: CustomPropertySelectValuesUpdateSelectValueBody,
  options?: OperationOptions,
) => Promise<CustomPropertySelectValuesUpdateSelectValueResponse>;

Параметры пути

ПолеТипОбязательность
property_idintegerОбязательно
idintegerОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
valuestringНеобязательно
colorinteger | nullНеобязательно
conditionactive | inactiveНеобязательно
sort_ordernumberНеобязательно
deletedbooleanНеобязательно

Ответ: Объект. Поля: created, updated, id, custom_property_id, value, color, author_id, company_id, sort_order, external_id, condition.

customPropertyTreeEntities ​

addTreeEntityToCustomProperty ​

client.customPropertyTreeEntities.addTreeEntityToCustomProperty · POST /api/latest/company/custom-properties/{property_id}/tree-entities

Add tree entity to custom property. Документация Kaiten.

...args: CustomPropertyTreeEntitiesAddTreeEntityToCustomPropertyParams

ts
declare const addTreeEntityToCustomProperty: (
  propertyId: number,
  treeEntityUid: string,
  options?: OperationOptions,
) => Promise<CustomPropertyTreeEntitiesAddTreeEntityToCustomPropertyResponse>;

Параметры пути

ПолеТипОбязательность
property_idintegerОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
tree_entity_uidstringОбязательно

Ответ: Объект. Поля: id.

deleteTreeEntityFromCustomProperty ​

client.customPropertyTreeEntities.deleteTreeEntityFromCustomProperty · DELETE /api/latest/company/custom-properties/{property_id}/tree-entities/{uid}

Delete tree entity from custom property. Документация Kaiten.

...args: CustomPropertyTreeEntitiesDeleteTreeEntityFromCustomPropertyParams

ts
declare const deleteTreeEntityFromCustomProperty: (
  propertyId: number,
  uid: string,
  options?: OperationOptions,
) => Promise<void>;

Параметры пути

ПолеТипОбязательность
property_idintegerОбязательно
uidstringОбязательно

Параметры запроса

нет.

Ответ: Без тела

getListOfCustomPropertyTreeEntities ​

client.customPropertyTreeEntities.getListOfCustomPropertyTreeEntities · GET /api/latest/company/custom-properties/{property_id}/tree-entities

Get list of custom property tree entities. Документация Kaiten.

...args: CustomPropertyTreeEntitiesGetListOfCustomPropertyTreeEntitiesParams

ts
declare const getListOfCustomPropertyTreeEntities: (
  propertyId: number,
  options?: OperationOptions,
) => Promise<CustomPropertyTreeEntitiesGetListOfCustomPropertyTreeEntitiesResponse>;

Параметры пути

ПолеТипОбязательность
property_idintegerОбязательно

Параметры запроса

нет.

Ответ: Массив. Поля: uid, title, company_id, sort_order, path, parent_entity_uid, entity_type, access, archived, for_everyone_access_role_id, protected.

documentGroups ​

createNewDocumentGroup ​

client.documentGroups.createNewDocumentGroup · POST /api/latest/document-groups

Create new document group. Документация Kaiten.

...args: DocumentGroupsCreateNewDocumentGroupParams

ts
declare const createNewDocumentGroup: (
  body: DocumentGroupsCreateNewDocumentGroupBody,
  options?: OperationOptions,
) => Promise<DocumentGroupsCreateNewDocumentGroupResponse>;

Параметры пути

нет.

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
titlestringОбязательно
parent_entity_uidstring | nullНеобязательно
for_everyone_access_role_idstring | nullНеобязательно
sort_ordernumberНеобязательно
keystring | nullНеобязательно

Ответ: Объект. Поля: uid, id, title, created, updated, archived, company_id, author_id, parent_entity_uid, parent_group_id, entity_type, sort_order, access, for_everyone_access_role_id, hostname, redirect_url, key, icon_type, icon_value, icon_color, public, news_feed, hidden_on_public_site, path, index_document_uid, access_record.

removeDocumentGroup ​

client.documentGroups.removeDocumentGroup · DELETE /api/latest/document-groups/{document_group_uid}

Remove document group. Документация Kaiten.

...args: DocumentGroupsRemoveDocumentGroupParams

ts
declare const removeDocumentGroup: (
  documentGroupUid: string,
  options?: OperationOptions,
) => Promise<DocumentGroupsRemoveDocumentGroupResponse>;

Параметры пути

ПолеТипОбязательность
document_group_uidstringОбязательно

Параметры запроса

нет.

Ответ: Объект. Поля: uid, id, title, created, updated, archived, company_id, author_id, parent_entity_uid, parent_group_id, entity_type, sort_order, access, for_everyone_access_role_id, hostname, redirect_url, key, icon_type, icon_value, icon_color, public, news_feed, hidden_on_public_site, path, index_document_uid.

retrieveDocumentGroup ​

client.documentGroups.retrieveDocumentGroup · GET /api/latest/document-groups/{document_group_uid}

Retrieve document group. Документация Kaiten.

...args: DocumentGroupsRetrieveDocumentGroupParams

ts
declare const retrieveDocumentGroup: (
  documentGroupUid: string,
  options?: OperationOptions,
) => Promise<DocumentGroupsRetrieveDocumentGroupResponse>;

Параметры пути

ПолеТипОбязательность
document_group_uidstringОбязательно

Параметры запроса

нет.

Ответ: Объект. Поля: uid, id, title, created, updated, archived, company_id, author_id, parent_entity_uid, parent_group_id, entity_type, sort_order, access, for_everyone_access_role_id, hostname, redirect_url, key, icon_type, icon_value, icon_color, public, news_feed, hidden_on_public_site, path, index_document_uid, access_record.

retrieveListOfDocumentGroups ​

client.documentGroups.retrieveListOfDocumentGroups · GET /api/latest/document-groups

Retrieve list of document groups. Документация Kaiten.

...args: DocumentGroupsRetrieveListOfDocumentGroupsParams

ts
declare const retrieveListOfDocumentGroups: {
  (
    query: DocumentGroupsRetrieveListOfDocumentGroupsQuery & {version: 2},
    options?: OperationOptions,
  ): Promise<
    SearchResponseV2<DocumentGroupsRetrieveListOfDocumentGroupsResponse>
  >;
  (
    query?: Omit<DocumentGroupsRetrieveListOfDocumentGroupsQuery, 'version'> & {
      version?: 1;
    },
    options?: OperationOptions,
  ): Promise<DocumentGroupsRetrieveListOfDocumentGroupsResponse>;
  (
    query: DocumentGroupsRetrieveListOfDocumentGroupsQuery | undefined,
    options?: OperationOptions,
  ): Promise<
    | DocumentGroupsRetrieveListOfDocumentGroupsResponse
    | SearchResponseV2<DocumentGroupsRetrieveListOfDocumentGroupsResponse>
  >;
};

При query.version: 2 возвращается SearchResponseV2<...> с полями result и position; без этого параметра возвращается массив.

Параметры пути

нет.

Параметры запроса

ПолеТипОбязательность
querystringНеобязательно
offsetintegerНеобязательно
limitintegerНеобязательно
versionintegerНеобязательно
conditionintegerНеобязательно
start_positionstringНеобязательно
roleintegerНеобязательно

Ответ: Массив. Поля: uid, id, title, created, updated, archived, company_id, author_id, parent_entity_uid, parent_group_id, entity_type, sort_order, access, for_everyone_access_role_id, hostname, redirect_url, key, icon_type, icon_value, icon_color, public, news_feed, hidden_on_public_site, path, index_document_uid.

updateDocumentGroup ​

client.documentGroups.updateDocumentGroup · PATCH /api/latest/document-groups/{document_group_uid}

Update document group. Документация Kaiten.

...args: DocumentGroupsUpdateDocumentGroupParams

ts
declare const updateDocumentGroup: (
  documentGroupUid: string,
  body: DocumentGroupsUpdateDocumentGroupBody,
  options?: OperationOptions,
) => Promise<DocumentGroupsUpdateDocumentGroupResponse>;

Параметры пути

ПолеТипОбязательность
document_group_uidstringОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
titlestringНеобязательно
parent_entity_uidstring | nullНеобязательно
sort_ordernumberНеобязательно
accessfor_everyone | by_inviteНеобязательно
for_everyone_access_role_idstring | nullНеобязательно
hostnamestring | nullНеобязательно
redirect_urlstring | nullНеобязательно
keystring | nullНеобязательно
icon_typematerial_icon | nullНеобязательно
icon_valuestring | nullНеобязательно
icon_colorinteger | nullНеобязательно
hidden_on_public_sitebooleanНеобязательно
news_feedbooleanНеобязательно
index_document_uidstring | nullНеобязательно

Ответ: Объект. Поля: uid, id, title, created, updated, archived, company_id, author_id, parent_entity_uid, parent_group_id, entity_type, sort_order, access, for_everyone_access_role_id, hostname, redirect_url, key, icon_type, icon_value, icon_color, public, news_feed, hidden_on_public_site, path, index_document_uid, access_record.

documentSchemas ​

getDocumentDataSchema ​

client.documentSchemas.getDocumentDataSchema · GET /api/latest/document-schemas/{id}

Get document data schema. Документация Kaiten.

...args: DocumentSchemasGetDocumentDataSchemaParams

ts
declare const getDocumentDataSchema: {
  (
    schemaVersion: string,
    format: 'prosemirror',
    options?: OperationOptions,
  ): Promise<DocumentProseMirrorSchema>;
  (
    schemaVersion: string,
    format?: 'draft-06',
    options?: OperationOptions,
  ): Promise<DocumentJsonSchema>;
  (
    schemaVersion: string,
    format: 'draft-06' | 'prosemirror' | undefined,
    options?: OperationOptions,
  ): Promise<DocumentSchemasGetDocumentDataSchemaResponse>;
};

Параметры пути

ПолеТипОбязательность
idstringОбязательно

Параметры запроса

ПолеТипОбязательность
formatdraft-06 | prosemirrorНеобязательно

Ответ: Объект. Поля: $schema, $id, title, description, allOf, version, definitions.

documents ​

createNewDocument ​

client.documents.createNewDocument · POST /api/latest/documents

Create new document. Документация Kaiten.

...args: DocumentsCreateNewDocumentParams

ts
declare const createNewDocument: (
  body: DocumentsCreateNewDocumentBody,
  options?: OperationOptions,
) => Promise<DocumentsCreateNewDocumentResponse>;

Параметры пути

нет.

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
titlestringНеобязательно
sort_ordernumberОбязательно
parent_entity_uidstring | nullНеобязательно
for_everyone_access_role_idstringНеобязательно
clone_uidstringНеобязательно
clone_versionnumberНеобязательно
keystring | nullНеобязательно

Ответ: Объект. Поля: uid, id, title, created, updated, archived, company_id, author_id, parent_entity_uid, entity_type, sort_order, access, for_everyone_access_role_id, data, version, published_version, publish_date, public, hidden_on_public_site, settings, key, redirect_url, icon_type, icon_value, icon_color, path, schema_version, notification_period_start, notification_period_end, group_id, access_record.

removeDocument ​

client.documents.removeDocument · DELETE /api/latest/documents/{document_uid}

Remove document. Документация Kaiten.

...args: DocumentsRemoveDocumentParams

ts
declare const removeDocument: (
  documentUid: string,
  options?: OperationOptions,
) => Promise<DocumentsRemoveDocumentResponse>;

Параметры пути

ПолеТипОбязательность
document_uidstringОбязательно

Параметры запроса

нет.

Ответ: Объект. Поля: uid, id, title, created, updated, archived, company_id, author_id, parent_entity_uid, entity_type, sort_order, access, for_everyone_access_role_id, version, published_version, publish_date, public, hidden_on_public_site, settings, key, redirect_url, icon_type, icon_value, icon_color, path, schema_version, notification_period_start, notification_period_end, group_id.

retrieveDocument ​

client.documents.retrieveDocument · GET /api/latest/documents/{document_uid}

Retrieve document. Документация Kaiten.

...args: DocumentsRetrieveDocumentParams

ts
declare const retrieveDocument: (
  documentUid: string,
  options?: OperationOptions,
) => Promise<DocumentsRetrieveDocumentResponse>;

Параметры пути

ПолеТипОбязательность
document_uidstringОбязательно

Параметры запроса

нет.

Ответ: Объект. Поля: uid, id, title, created, updated, archived, company_id, author_id, parent_entity_uid, entity_type, sort_order, access, for_everyone_access_role_id, data, version, published_version, publish_date, public, hidden_on_public_site, settings, key, redirect_url, icon_type, icon_value, icon_color, path, schema_version, notification_period_start, notification_period_end, group_id, access_record.

retrieveListOfDocuments ​

client.documents.retrieveListOfDocuments · GET /api/latest/documents

Retrieve list of documents. Документация Kaiten.

...args: DocumentsRetrieveListOfDocumentsParams

ts
declare const retrieveListOfDocuments: {
  (
    query: DocumentsRetrieveListOfDocumentsQuery & {version: 2},
    options?: OperationOptions,
  ): Promise<SearchResponseV2<DocumentsRetrieveListOfDocumentsResponse>>;
  (
    query?: Omit<DocumentsRetrieveListOfDocumentsQuery, 'version'> & {
      version?: 1;
    },
    options?: OperationOptions,
  ): Promise<DocumentsRetrieveListOfDocumentsResponse>;
  (
    query: DocumentsRetrieveListOfDocumentsQuery | undefined,
    options?: OperationOptions,
  ): Promise<
    | DocumentsRetrieveListOfDocumentsResponse
    | SearchResponseV2<DocumentsRetrieveListOfDocumentsResponse>
  >;
};

При query.version: 2 возвращается SearchResponseV2<...> с полями result и position; без этого параметра возвращается массив.

Параметры пути

нет.

Параметры запроса

ПолеТипОбязательность
querystringНеобязательно
offsetintegerНеобязательно
limitintegerНеобязательно
versionintegerНеобязательно
conditionintegerНеобязательно
fieldsstringНеобязательно
start_positionstringНеобязательно
include_search_previewbooleanНеобязательно

Ответ: Массив. Поля: uid, id, title, created, updated, archived, company_id, author_id, parent_entity_uid, entity_type, sort_order, access, for_everyone_access_role_id, version, published_version, publish_date, public, hidden_on_public_site, settings, key, redirect_url, icon_type, icon_value, icon_color, path, schema_version, notification_period_start, notification_period_end, group_id.

updateDocument ​

client.documents.updateDocument · PATCH /api/latest/documents/{document_uid}

Update document. Документация Kaiten.

...args: DocumentsUpdateDocumentParams

ts
declare const updateDocument: (
  documentUid: string,
  body: DocumentsUpdateDocumentBody,
  options?: OperationOptions,
) => Promise<DocumentsUpdateDocumentResponse>;

Параметры пути

ПолеТипОбязательность
document_uidstringОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
titlestringНеобязательно
sort_ordernumberНеобязательно
publish_datestring | nullНеобязательно
dataobjectНеобязательно
accessfor_everyone | by_inviteНеобязательно
parent_entity_uidstring | nullНеобязательно
for_everyone_access_role_idstringНеобязательно
publicbooleanНеобязательно
redirect_urlstring | nullНеобязательно
hidden_on_public_sitebooleanНеобязательно
settingsobjectНеобязательно
backup_versionnumberНеобязательно
published_versionnumber | null | currentНеобязательно
keystring | nullНеобязательно
icon_typeemoji | material_icon | nullНеобязательно
icon_valuestring | nullНеобязательно
icon_colorinteger | nullНеобязательно
notification_period_startstring | nullНеобязательно
notification_period_endstring | nullНеобязательно
slugstring | nullНеобязательно

Ответ: Объект. Поля: uid, id, title, created, updated, archived, company_id, author_id, parent_entity_uid, entity_type, sort_order, access, for_everyone_access_role_id, data, version, published_version, publish_date, public, hidden_on_public_site, settings, key, redirect_url, icon_type, icon_value, icon_color, path, schema_version, notification_period_start, notification_period_end, group_id, access_record.

groupAdmins ​

addAdminToGroup ​

client.groupAdmins.addAdminToGroup · POST /api/latest/groups/{group_uid}/admins

Add admin to group. Документация Kaiten. Beta.

...args: GroupAdminsAddAdminToGroupParams

ts
declare const addAdminToGroup: (
  groupUid: string,
  userId: number,
  options?: OperationOptions,
) => Promise<GroupAdminsAddAdminToGroupResponse>;

Параметры пути

ПолеТипОбязательность
group_uidstringОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
user_idintegerОбязательно

Ответ: Объект. Поля: id, uid, full_name, email, username, avatar_initials_url, avatar_uploaded_url, initials, avatar_type, lng, timezone, theme, created, updated, activated, ui_version, virtual, email_blocked, email_blocked_reason, delete_requested_at.

getListOfGroupAdmins ​

client.groupAdmins.getListOfGroupAdmins · GET /api/latest/groups/{group_uid}/admins

Get list of group admins. Документация Kaiten. Beta.

...args: GroupAdminsGetListOfGroupAdminsParams

ts
declare const getListOfGroupAdmins: (
  groupUid: string,
  options?: OperationOptions,
) => Promise<GroupAdminsGetListOfGroupAdminsResponse>;

Параметры пути

ПолеТипОбязательность
group_uidstringОбязательно

Параметры запроса

нет.

Ответ: Массив. Поля: created, updated, id, uid, full_name, username, email, activated, avatar_initials_url, avatar_uploaded_url, initials, avatar_type, lng, sd_telegram_id, timezone, news_subscription, theme, ui_version, virtual, email_blocked, email_blocked_reason, delete_requested_at, delete_confirmation_sent_at.

removeAdminFromGroup ​

client.groupAdmins.removeAdminFromGroup · DELETE /api/latest/groups/{group_uid}/admins/{user_id}

Remove admin from group. Документация Kaiten. Beta.

...args: GroupAdminsRemoveAdminFromGroupParams

ts
declare const removeAdminFromGroup: (
  groupUid: string,
  userId: number,
  options?: OperationOptions,
) => Promise<GroupAdminsRemoveAdminFromGroupResponse>;

Параметры пути

ПолеТипОбязательность
group_uidstringОбязательно
user_idintegerОбязательно

Параметры запроса

нет.

Ответ: Объект. Поля: id, uid, full_name, email, username, avatar_initials_url, avatar_uploaded_url, initials, avatar_type, lng, timezone, theme, created, updated, activated, ui_version, virtual, email_blocked, email_blocked_reason, delete_requested_at.

groupEntities ​

addEntity ​

client.groupEntities.addEntity · POST /api/latest/company/groups/{group_uid}/entities

Add entity. Документация Kaiten. Beta.

...args: GroupEntitiesAddEntityParams

ts
declare const addEntity: (
  groupUid: string,
  entityUid: string,
  roleIds: string[],
  options?: OperationOptions,
) => Promise<GroupEntitiesAddEntityResponse>;

Параметры пути

ПолеТипОбязательность
group_uidstringОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
entity_uidstringОбязательно
role_idsarray of stringОбязательно

Ответ: Объект. Поля: group_id, entity_uid, role_permissions, access_mod, own_role_ids, own_access_mod, role_ids.

getListOfGroupEntities ​

client.groupEntities.getListOfGroupEntities · GET /api/latest/company/groups/{group_uid}/entities

Get list of group entities. Документация Kaiten. Beta.

...args: GroupEntitiesGetListOfGroupEntitiesParams

ts
declare const getListOfGroupEntities: (
  groupUid: string,
  options?: OperationOptions,
) => Promise<GroupEntitiesGetListOfGroupEntitiesResponse>;

Параметры пути

ПолеТипОбязательность
group_uidstringОбязательно

Параметры запроса

нет.

Ответ: Массив. Поля: uid, path, title, entity_type, own_role_ids.

removeEntity ​

client.groupEntities.removeEntity · DELETE /api/latest/company/groups/{group_uid}/entities/{uid}

Remove entity. Документация Kaiten. Beta.

...args: GroupEntitiesRemoveEntityParams

ts
declare const removeEntity: (
  groupUid: string,
  uid: string,
  options?: OperationOptions,
) => Promise<GroupEntitiesRemoveEntityResponse>;

Параметры пути

ПолеТипОбязательность
group_uidstringОбязательно
uidstringОбязательно

Параметры запроса

нет.

Ответ: Объект. Поля: group_id, entity_uid, role_permissions, access_mod, role, own_role_ids, own_access_mod, role_ids, own_role.

updateGroupEntity ​

client.groupEntities.updateGroupEntity · PATCH /api/latest/company/groups/{group_uid}/entities/{uid}

Update group entity. Документация Kaiten. Beta.

...args: GroupEntitiesUpdateGroupEntityParams

ts
declare const updateGroupEntity: (
  groupUid: string,
  uid: string,
  roleIds: string[],
  options?: OperationOptions,
) => Promise<GroupEntitiesUpdateGroupEntityResponse>;

Параметры пути

ПолеТипОбязательность
group_uidstringОбязательно
uidstringОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
role_idsarray of stringНеобязательно

Ответ: Объект. Поля: group_id, entity_uid, role_permissions, access_mod, own_role_ids, own_access_mod, role_ids.

groupUsers ​

addUserToGroup ​

client.groupUsers.addUserToGroup · POST /api/latest/groups/{group_uid}/users

Add user to group. Документация Kaiten. Beta.

...args: GroupUsersAddUserToGroupParams

ts
declare const addUserToGroup: (
  groupUid: string,
  userId: number,
  requestId?: string,
  operatorComment?: string | null,
  options?: OperationOptions,
) => Promise<GroupUsersAddUserToGroupResponse>;

Параметры пути

ПолеТипОбязательность
group_uidstringОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
user_idintegerОбязательно
request_idstringНеобязательно
operator_commentstring | nullНеобязательно

Ответ: Объект. Поля: id, uid, full_name, email, username, avatar_initials_url, avatar_uploaded_url, initials, avatar_type, lng, timezone, theme, created, updated, activated, ui_version, virtual, email_blocked, email_blocked_reason, delete_requested_at.

getListOfGroupUsers ​

client.groupUsers.getListOfGroupUsers · GET /api/latest/groups/{group_uid}/users

Get list of group users. Документация Kaiten. Beta.

...args: GroupUsersGetListOfGroupUsersParams

ts
declare const getListOfGroupUsers: (
  groupUid: string,
  options?: OperationOptions,
) => Promise<GroupUsersGetListOfGroupUsersResponse>;

Параметры пути

ПолеТипОбязательность
group_uidstringОбязательно

Параметры запроса

нет.

Ответ: Массив. Поля: created, updated, id, uid, full_name, username, email, activated, avatar_initials_url, avatar_uploaded_url, initials, avatar_type, lng, sd_telegram_id, timezone, news_subscription, theme, ui_version, virtual, email_blocked, email_blocked_reason, delete_requested_at, delete_confirmation_sent_at.

removeUserFromGroup ​

client.groupUsers.removeUserFromGroup · DELETE /api/latest/groups/{group_uid}/users/{user_id}

Remove user from group. Документация Kaiten. Beta.

...args: GroupUsersRemoveUserFromGroupParams

ts
declare const removeUserFromGroup: (
  groupUid: string,
  userId: number,
  options?: OperationOptions,
) => Promise<GroupUsersRemoveUserFromGroupResponse>;

Параметры пути

ПолеТипОбязательность
group_uidstringОбязательно
user_idintegerОбязательно

Параметры запроса

нет.

Ответ: Объект. Поля: id, uid, full_name, email, username, avatar_initials_url, avatar_uploaded_url, initials, avatar_type, lng, timezone, theme, created, updated, activated, ui_version, virtual, email_blocked, email_blocked_reason, delete_requested_at.

groups ​

createGroup ​

client.groups.createGroup · POST /api/latest/company/groups

Create group. Документация Kaiten. Beta.

...args: GroupsCreateGroupParams

ts
declare const createGroup: (
  name: string,
  permissions?: number,
  addToCardsAndSpacesEnabled?: boolean,
  options?: OperationOptions,
) => Promise<GroupsCreateGroupResponse>;

Параметры пути

нет.

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
namestringОбязательно
permissionsintegerНеобязательно
add_to_cards_and_spaces_enabledbooleanНеобязательно

Ответ: Объект. Поля: name, permissions, add_to_cards_and_spaces_enabled, updated, created, id, uid.

getGroup ​

client.groups.getGroup · GET /api/latest/company/groups/{uid}

Get group. Документация Kaiten. Beta.

...args: GroupsGetGroupParams

ts
declare const getGroup: (
  uid: string,
  options?: OperationOptions,
) => Promise<GroupsGetGroupResponse>;

Параметры пути

ПолеТипОбязательность
uidstringОбязательно

Параметры запроса

нет.

Ответ: Объект. Поля: name, permissions, add_to_cards_and_spaces_enabled, updated, created, id, uid.

getListOfGroups ​

client.groups.getListOfGroups · GET /api/latest/company/groups

Get list of groups. Документация Kaiten. Beta.

...args: GroupsGetListOfGroupsParams

ts
declare const getListOfGroups: (
  query?: GroupsGetListOfGroupsQuery,
  options?: OperationOptions,
) => Promise<GroupsGetListOfGroupsResponse>;

Параметры пути

нет.

Параметры запроса

ПолеТипОбязательность
with_tree_entitiesbooleanНеобязательно
with_users_countbooleanНеобязательно
with_sync_group_attributebooleanНеобязательно
conditionenumНеобязательно
querystringНеобязательно
limitintegerНеобязательно
offsetintegerНеобязательно

Ответ: Массив. Поля: name, permissions, add_to_cards_and_spaces_enabled, updated, created, id, uid.

removeGroup ​

client.groups.removeGroup · DELETE /api/latest/company/groups/{uid}

Remove Group. Документация Kaiten. Beta.

...args: GroupsRemoveGroupParams

ts
declare const removeGroup: (
  uid: string,
  options?: OperationOptions,
) => Promise<GroupsRemoveGroupResponse>;

Параметры пути

ПолеТипОбязательность
uidstringОбязательно

Параметры запроса

нет.

Ответ: Объект. Поля: name, permissions, add_to_cards_and_spaces_enabled, updated, created, id, uid.

updateGroup ​

client.groups.updateGroup · PATCH /api/latest/company/groups/{uid}

Update group. Документация Kaiten. Beta.

...args: GroupsUpdateGroupParams

ts
declare const updateGroup: (
  uid: string,
  name?: string,
  permissions?: number,
  addToCardsAndSpacesEnabled?: boolean,
  options?: OperationOptions,
) => Promise<GroupsUpdateGroupResponse>;

Параметры пути

ПолеТипОбязательность
uidstringОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
namestringНеобязательно
permissionsintegerНеобязательно
add_to_cards_and_spaces_enabledbooleanНеобязательно

Ответ: Объект. Поля: name, permissions, add_to_cards_and_spaces_enabled, updated, created, id, uid.

iterations ​

addCardToIteration ​

client.iterations.addCardToIteration · POST /api/latest/spaces/{space_uid}/iterations/{iteration_id}/cards

Add card to iteration. Документация Kaiten. Beta.

...args: IterationsAddCardToIterationParams

ts
declare const addCardToIteration: (
  spaceUid: string,
  iterationId: string,
  cardUid: string,
  options?: OperationOptions,
) => Promise<IterationsAddCardToIterationResponse>;

Параметры пути

ПолеТипОбязательность
space_uidstringОбязательно
iteration_idstringОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
card_uidstringОбязательно

Ответ: Объект. Поля: iteration_id, card_uid, added_by_uid, removed_at, removed_by_uid, sort_order, created, updated.

createIteration ​

client.iterations.createIteration · POST /api/latest/spaces/{space_uid}/iterations

Create iteration. Документация Kaiten. Beta.

...args: IterationsCreateIterationParams

ts
declare const createIteration: (
  spaceUid: string,
  body: IterationsCreateIterationBody,
  options?: OperationOptions,
) => Promise<IterationsCreateIterationResponse>;

Параметры пути

ПолеТипОбязательность
space_uidstringОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
titlestringОбязательно
goalstring | nullНеобязательно
start_datestring | nullНеобязательно
finish_datestring | nullНеобязательно

Ответ: Объект. Поля: id, space_uid, title, goal, status, creator_uid, updater_uid, start_date, finish_date, actual_finish_date, sort_order, data, created, updated.

deleteIteration ​

client.iterations.deleteIteration · DELETE /api/latest/spaces/{space_uid}/iterations/{id}

Delete iteration. Документация Kaiten. Beta.

...args: IterationsDeleteIterationParams

ts
declare const deleteIteration: (
  spaceUid: string,
  id: string,
  newIterationId?: string | null,
  options?: OperationOptions,
) => Promise<IterationsDeleteIterationResponse>;

Параметры пути

ПолеТипОбязательность
space_uidstringОбязательно
idstringОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
new_iteration_idstring | nullНеобязательно

Ответ: Объект. Поля: id, space_uid, title, goal, status, creator_uid, updater_uid, start_date, finish_date, actual_finish_date, sort_order, data, moved_cards, created, updated.

getCardIterationsHistory ​

client.iterations.getCardIterationsHistory · GET /api/latest/cards/{card_uid}/iterations-history

Get card iterations history. Документация Kaiten. Beta.

...args: IterationsGetCardIterationsHistoryParams

ts
declare const getCardIterationsHistory: (
  cardUid: string,
  withDetails?: boolean,
  options?: OperationOptions,
) => Promise<IterationsGetCardIterationsHistoryResponse>;

Параметры пути

ПолеТипОбязательность
card_uidstringОбязательно

Параметры запроса

ПолеТипОбязательность
with_detailsbooleanНеобязательно

Ответ: Массив. Поля: iteration_id, card_uid, added_by_uid, removed_at, removed_by_uid, sort_order, created, updated.

getIteration ​

client.iterations.getIteration · GET /api/latest/spaces/{space_uid}/iterations/{id}

Get iteration. Документация Kaiten. Beta.

...args: IterationsGetIterationParams

ts
declare const getIteration: (
  spaceUid: string,
  id: string,
  options?: OperationOptions,
) => Promise<IterationsGetIterationResponse>;

Параметры пути

ПолеТипОбязательность
space_uidstringОбязательно
idstringОбязательно

Параметры запроса

нет.

Ответ: Объект. Поля: id, space_uid, title, goal, status, creator_uid, updater_uid, start_date, finish_date, actual_finish_date, sort_order, data, created, updated.

removeCardFromIteration ​

client.iterations.removeCardFromIteration · DELETE /api/latest/spaces/{space_uid}/iterations/{iteration_id}/cards/{uid}

Remove card from iteration. Документация Kaiten. Beta.

...args: IterationsRemoveCardFromIterationParams

ts
declare const removeCardFromIteration: (
  spaceUid: string,
  iterationId: string,
  uid: string,
  options?: OperationOptions,
) => Promise<IterationsRemoveCardFromIterationResponse>;

Параметры пути

ПолеТипОбязательность
space_uidstringОбязательно
iteration_idstringОбязательно
uidstringОбязательно

Параметры запроса

нет.

Ответ: Объект. Поля: iteration_id, card_uid, added_by_uid, removed_at, removed_by_uid, sort_order, created, updated.

retrieveCardsInIteration ​

client.iterations.retrieveCardsInIteration · GET /api/latest/spaces/{space_uid}/iterations/{iteration_id}/cards

Retrieve cards in iteration. Документация Kaiten. Beta.

...args: IterationsRetrieveCardsInIterationParams

ts
declare const retrieveCardsInIteration: (
  spaceUid: string,
  iterationId: string,
  status?: string,
  options?: OperationOptions,
) => Promise<IterationsRetrieveCardsInIterationResponse>;

Параметры пути

ПолеТипОбязательность
space_uidstringОбязательно
iteration_idstringОбязательно

Параметры запроса

ПолеТипОбязательность
statusstringНеобязательно

Ответ: Массив. Поля: iteration_id, card_uid, card_id, added_by_uid, removed_at, removed_by_uid, sort_order, created, updated.

retrieveListOfIterations ​

client.iterations.retrieveListOfIterations · GET /api/latest/spaces/{space_uid}/iterations

Retrieve list of iterations. Документация Kaiten. Beta.

...args: IterationsRetrieveListOfIterationsParams

ts
declare const retrieveListOfIterations: (
  spaceUid: string,
  query?: IterationsRetrieveListOfIterationsQuery,
  options?: OperationOptions,
) => Promise<IterationsRetrieveListOfIterationsResponse>;

Параметры пути

ПолеТипОбязательность
space_uidstringОбязательно

Параметры запроса

ПолеТипОбязательность
statusstringНеобязательно
with_datastringНеобязательно
limitnumberНеобязательно
offsetnumberНеобязательно
orderstringНеобязательно

Ответ: Массив. Поля: id, space_uid, title, goal, status, creator_uid, updater_uid, start_date, finish_date, actual_finish_date, sort_order, data, created, updated.

updateIteration ​

client.iterations.updateIteration · PATCH /api/latest/spaces/{space_uid}/iterations/{id}

Update iteration. Документация Kaiten. Beta.

...args: IterationsUpdateIterationParams

ts
declare const updateIteration: (
  spaceUid: string,
  id: string,
  body: IterationsUpdateIterationBody,
  options?: OperationOptions,
) => Promise<IterationsUpdateIterationResponse>;

Параметры пути

ПолеТипОбязательность
space_uidstringОбязательно
idstringОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
titlestringНеобязательно
goalstring | nullНеобязательно
statusplanned | active | closedНеобязательно
start_datestring | nullНеобязательно
finish_datestring | nullНеобязательно
actual_finish_datestring | nullНеобязательно
new_iteration_idstring | nullНеобязательно

Ответ: Объект. Поля: id, space_uid, title, goal, status, creator_uid, updater_uid, start_date, finish_date, actual_finish_date, sort_order, data, created, updated.

lanes ​

createNewLane ​

client.lanes.createNewLane · POST /api/latest/boards/{board_id}/lanes

Create new lane. Документация Kaiten.

...args: LanesCreateNewLaneParams

ts
declare const createNewLane: (
  boardId: number,
  body: LanesCreateNewLaneBody,
  options?: OperationOptions,
) => Promise<LanesCreateNewLaneResponse>;

Параметры пути

ПолеТипОбязательность
board_idintegerОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
titlestringОбязательно
sort_ordernumberНеобязательно
wip_limitintegerНеобязательно
wip_limit_type1 | 2Необязательно
last_moved_warning_after_daysintegerНеобязательно
last_moved_warning_after_hoursintegerНеобязательно
last_moved_warning_after_minutesintegerНеобязательно
row_countintegerНеобязательно

Ответ: Объект. Поля: created, updated, id, title, sort_order, row_count, wip_limit, wip_limit_type, last_moved_warning_after_minutes, last_moved_warning_after_days, last_moved_warning_after_hours, board_id, default_card_type_id, default_tags, external_id, condition.

getListOfLanes ​

client.lanes.getListOfLanes · GET /api/latest/boards/{board_id}/lanes

Get list of lanes. Документация Kaiten.

...args: LanesGetListOfLanesParams

ts
declare const getListOfLanes: (
  boardId: number,
  condition?: string,
  options?: OperationOptions,
) => Promise<LanesGetListOfLanesResponse>;

Параметры пути

ПолеТипОбязательность
board_idintegerОбязательно

Параметры запроса

ПолеТипОбязательность
conditionenumНеобязательно

Ответ: Массив. Поля: created, updated, id, title, sort_order, row_count, board_id, wip_limit, wip_limit_type, default_tags, last_moved_warning_after_days, external_id, default_card_type_id, last_moved_warning_after_hours, condition, last_moved_warning_after_minutes.

removeLane ​

client.lanes.removeLane · DELETE /api/latest/boards/{board_id}/lanes/{id}

Remove lane. Документация Kaiten.

...args: LanesRemoveLaneParams

ts
declare const removeLane: (
  boardId: number,
  laneId: number,
  force?: boolean,
  options?: OperationOptions,
) => Promise<LanesRemoveLaneResponse>;

Параметры пути

ПолеТипОбязательность
board_idintegerОбязательно
idintegerОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
forcebooleanНеобязательно

Ответ: Объект. Поля: id.

updateLane ​

client.lanes.updateLane · PATCH /api/latest/boards/{board_id}/lanes/{id}

Update lane. Документация Kaiten.

...args: LanesUpdateLaneParams

ts
declare const updateLane: (
  boardId: number,
  laneId: number,
  body: LanesUpdateLaneBody,
  options?: OperationOptions,
) => Promise<LanesUpdateLaneResponse>;

Параметры пути

ПолеТипОбязательность
board_idintegerОбязательно
idintegerОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
titlestringНеобязательно
sort_ordernumberНеобязательно
wip_limitinteger | nullНеобязательно
wip_limit_type1 | 2Необязательно
last_moved_warning_after_daysintegerНеобязательно
last_moved_warning_after_hoursintegerНеобязательно
last_moved_warning_after_minutesintegerНеобязательно
row_countintegerНеобязательно
default_tagsstring | nullНеобязательно
default_card_type_idinteger | nullНеобязательно
condition1 | 2Необязательно

Ответ: Объект. Поля: created, updated, id, title, sort_order, row_count, wip_limit, wip_limit_type, last_moved_warning_after_minutes, last_moved_warning_after_days, last_moved_warning_after_hours, board_id, default_card_type_id, default_tags, external_id, condition.

restrictedAccessCardFiles ​

attachFileToCard ​

client.restrictedAccessCardFiles.attachFileToCard · POST /api/latest/cards/{card_uid}/files

Attach file to card. Документация Kaiten.

...args: RestrictedAccessCardFilesAttachFileToCardParams

ts
declare const attachFileToCard: (
  cardUid: string,
  file: Blob,
  options?: FileUploadOptions,
) => Promise<RestrictedAccessCardFilesAttachFileToCardResponse>;

Параметры пути

ПолеТипОбязательность
card_uidstring (uuid)Обязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
fileBlobОбязательно

Ответ: Объект. Поля: id, name, size, mime_type, author_uid, card_uid, company_uid, entity_type, created, updated, card_cover.

deleteCardFile ​

client.restrictedAccessCardFiles.deleteCardFile · DELETE /api/latest/cards/{card_uid}/files/{id}

Delete card file. Документация Kaiten.

...args: RestrictedAccessCardFilesDeleteCardFileParams

ts
declare const deleteCardFile: (
  cardUid: string,
  fileUid: string,
  options?: OperationOptions,
) => Promise<RestrictedAccessCardFilesDeleteCardFileResponse>;

Параметры пути

ПолеТипОбязательность
card_uidstring (uuid)Обязательно
idstring (uuid)Обязательно

Параметры запроса

нет.

Ответ: Объект. Поля: id.

getCardFile ​

client.restrictedAccessCardFiles.getCardFile · GET /api/latest/cards/{card_uid}/files/{id}

Get card file. Документация Kaiten.

...args: RestrictedAccessCardFilesGetCardFileParams

ts
declare const getCardFile: {
  (
    cardUid: string,
    fileUid: string,
    redirect: true,
    download?: boolean,
    options?: OperationOptions,
  ): Promise<FileRedirectResponse>;
  (
    cardUid: string,
    fileUid: string,
    redirect?: false,
    download?: boolean,
    options?: OperationOptions,
  ): Promise<RestrictedAccessCardFilesGetCardFileResponse>;
  (
    cardUid: string,
    fileUid: string,
    redirect: boolean | undefined,
    download?: boolean,
    options?: OperationOptions,
  ): Promise<
    RestrictedAccessCardFilesGetCardFileResponse | FileRedirectResponse
  >;
};

Параметры пути

ПолеТипОбязательность
card_uidstring (uuid)Обязательно
idstring (uuid)Обязательно

Параметры запроса

ПолеТипОбязательность
redirectbooleanНеобязательно
downloadbooleanНеобязательно

Ответ: Объект. Поля: id, name, size, mime_type, entity_type, created, updated, card_uid, author_uid, card_cover, url.

updateCardFile ​

client.restrictedAccessCardFiles.updateCardFile · PATCH /api/latest/cards/{card_uid}/files/{id}

Update card file. Документация Kaiten.

...args: RestrictedAccessCardFilesUpdateCardFileParams

ts
declare const updateCardFile: (
  cardUid: string,
  fileUid: string,
  name?: string,
  cardCover?: boolean,
  options?: OperationOptions,
) => Promise<RestrictedAccessCardFilesUpdateCardFileResponse>;

Параметры пути

ПолеТипОбязательность
card_uidstring (uuid)Обязательно
idstring (uuid)Обязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
namestringНеобязательно
card_coverbooleanНеобязательно

Ответ: Объект. Поля: id, name, size, mime_type, author_uid, card_uid, company_uid, entity_type, created, updated, card_cover.

restrictedAccessCommentFiles ​

attachFileToComment ​

client.restrictedAccessCommentFiles.attachFileToComment · POST /api/latest/cards/{card_uid}/comments/{comment_uid}/files

Attach file to comment. Документация Kaiten.

...args: RestrictedAccessCommentFilesAttachFileToCommentParams

ts
declare const attachFileToComment: (
  cardUid: string,
  commentUid: string,
  file: Blob,
  options?: FileUploadOptions,
) => Promise<RestrictedAccessCommentFilesAttachFileToCommentResponse>;

Параметры пути

ПолеТипОбязательность
card_uidstring (uuid)Обязательно
comment_uidstring (uuid | new)Обязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
fileBlobОбязательно

Ответ: Объект. Поля: id, name, size, mime_type, author_uid, card_uid, comment_uid, company_uid, entity_type, created, updated, card_cover.

deleteCommentFile ​

client.restrictedAccessCommentFiles.deleteCommentFile · DELETE /api/latest/cards/{card_uid}/comments/{comment_uid}/files/{id}

Delete comment file. Документация Kaiten.

...args: RestrictedAccessCommentFilesDeleteCommentFileParams

ts
declare const deleteCommentFile: (
  cardUid: string,
  commentUid: string,
  fileUid: string,
  options?: OperationOptions,
) => Promise<RestrictedAccessCommentFilesDeleteCommentFileResponse>;

Параметры пути

ПолеТипОбязательность
card_uidstring (uuid)Обязательно
comment_uidstring (uuid | new)Обязательно
idstring (uuid)Обязательно

Параметры запроса

нет.

Ответ: Объект. Поля: id.

getCommentFile ​

client.restrictedAccessCommentFiles.getCommentFile · GET /api/latest/cards/{card_uid}/comments/{comment_uid}/files/{id}

Get comment file. Документация Kaiten.

...args: RestrictedAccessCommentFilesGetCommentFileParams

ts
declare const getCommentFile: {
  (
    cardUid: string,
    commentUid: string,
    fileUid: string,
    query: RestrictedAccessCommentFilesGetCommentFileQuery & {redirect: true},
    options?: OperationOptions,
  ): Promise<FileRedirectResponse>;
  (
    cardUid: string,
    commentUid: string,
    fileUid: string,
    query?: Omit<
      RestrictedAccessCommentFilesGetCommentFileQuery,
      'redirect'
    > & {redirect?: false},
    options?: OperationOptions,
  ): Promise<RestrictedAccessCommentFilesGetCommentFileResponse>;
  (
    cardUid: string,
    commentUid: string,
    fileUid: string,
    query: RestrictedAccessCommentFilesGetCommentFileQuery | undefined,
    options?: OperationOptions,
  ): Promise<
    RestrictedAccessCommentFilesGetCommentFileResponse | FileRedirectResponse
  >;
};

Параметры пути

ПолеТипОбязательность
card_uidstring (uuid)Обязательно
comment_uidstring (uuid | new)Обязательно
idstring (uuid)Обязательно

Параметры запроса

ПолеТипОбязательность
redirectbooleanНеобязательно
downloadbooleanНеобязательно

Ответ: Объект. Поля: id, name, size, mime_type, entity_type, created, updated, card_uid, comment_uid, author_uid, card_cover, url.

updateCommentFile ​

client.restrictedAccessCommentFiles.updateCommentFile · PATCH /api/latest/cards/{card_uid}/comments/{comment_uid}/files/{id}

Update comment file. Документация Kaiten.

...args: RestrictedAccessCommentFilesUpdateCommentFileParams

ts
declare const updateCommentFile: (
  cardUid: string,
  commentUid: string,
  fileUid: string,
  body: RestrictedAccessCommentFilesUpdateCommentFileBody,
  options?: OperationOptions,
) => Promise<RestrictedAccessCommentFilesUpdateCommentFileResponse>;

Параметры пути

ПолеТипОбязательность
card_uidstring (uuid)Обязательно
comment_uidstring (uuid | new)Обязательно
idstring (uuid)Обязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
namestringНеобязательно
card_coverbooleanНеобязательно

Ответ: Объект. Поля: id, name, size, mime_type, author_uid, card_uid, comment_uid, company_uid, entity_type, created, updated, card_cover.

restrictedAccessCustomPropertyFiles ​

attachFileToCustomProperty ​

client.restrictedAccessCustomPropertyFiles.attachFileToCustomProperty · POST /api/latest/cards/{card_uid}/custom-properties/{property_uid}/files

Attach file to custom property. Документация Kaiten.

...args: RestrictedAccessCustomPropertyFilesAttachFileToCustomPropertyParams

ts
declare const attachFileToCustomProperty: (
  cardUid: string,
  propertyUid: string,
  file: Blob,
  options?: FileUploadOptions,
) => Promise<RestrictedAccessCustomPropertyFilesAttachFileToCustomPropertyResponse>;

Параметры пути

ПолеТипОбязательность
card_uidstring (uuid)Обязательно
property_uidstring (uuid)Обязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
fileBlobОбязательно

Ответ: Объект. Поля: id, name, size, mime_type, author_uid, card_uid, custom_property_uid, company_uid, entity_type, created, updated, card_cover.

deleteCustomPropertyFile ​

client.restrictedAccessCustomPropertyFiles.deleteCustomPropertyFile · DELETE /api/latest/cards/{card_uid}/custom-properties/{property_uid}/files/{id}

Delete custom property file. Документация Kaiten.

...args: RestrictedAccessCustomPropertyFilesDeleteCustomPropertyFileParams

ts
declare const deleteCustomPropertyFile: (
  cardUid: string,
  propertyUid: string,
  fileUid: string,
  options?: OperationOptions,
) => Promise<RestrictedAccessCustomPropertyFilesDeleteCustomPropertyFileResponse>;

Параметры пути

ПолеТипОбязательность
card_uidstring (uuid)Обязательно
property_uidstring (uuid)Обязательно
idstring (uuid)Обязательно

Параметры запроса

нет.

Ответ: Объект. Поля: id.

getCustomPropertyFile ​

client.restrictedAccessCustomPropertyFiles.getCustomPropertyFile · GET /api/latest/cards/{card_uid}/custom-properties/{property_uid}/files/{id}

Get custom property file. Документация Kaiten.

...args: RestrictedAccessCustomPropertyFilesGetCustomPropertyFileParams

ts
declare const getCustomPropertyFile: {
  (
    cardUid: string,
    propertyUid: string,
    fileUid: string,
    query: RestrictedAccessCustomPropertyFilesGetCustomPropertyFileQuery & {
      redirect: true;
    },
    options?: OperationOptions,
  ): Promise<FileRedirectResponse>;
  (
    cardUid: string,
    propertyUid: string,
    fileUid: string,
    query?: Omit<
      RestrictedAccessCustomPropertyFilesGetCustomPropertyFileQuery,
      'redirect'
    > & {redirect?: false},
    options?: OperationOptions,
  ): Promise<RestrictedAccessCustomPropertyFilesGetCustomPropertyFileResponse>;
  (
    cardUid: string,
    propertyUid: string,
    fileUid: string,
    query:
      RestrictedAccessCustomPropertyFilesGetCustomPropertyFileQuery | undefined,
    options?: OperationOptions,
  ): Promise<
    | RestrictedAccessCustomPropertyFilesGetCustomPropertyFileResponse
    | FileRedirectResponse
  >;
};

Параметры пути

ПолеТипОбязательность
card_uidstring (uuid)Обязательно
property_uidstring (uuid)Обязательно
idstring (uuid)Обязательно

Параметры запроса

ПолеТипОбязательность
redirectbooleanНеобязательно
downloadbooleanНеобязательно

Ответ: Объект. Поля: id, name, size, mime_type, entity_type, created, updated, card_uid, custom_property_uid, author_uid, card_cover, url.

updateCustomPropertyFile ​

client.restrictedAccessCustomPropertyFiles.updateCustomPropertyFile · PATCH /api/latest/cards/{card_uid}/custom-properties/{property_uid}/files/{id}

Update custom property file. Документация Kaiten.

...args: RestrictedAccessCustomPropertyFilesUpdateCustomPropertyFileParams

ts
declare const updateCustomPropertyFile: (
  cardUid: string,
  propertyUid: string,
  fileUid: string,
  body: RestrictedAccessCustomPropertyFilesUpdateCustomPropertyFileBody,
  options?: OperationOptions,
) => Promise<RestrictedAccessCustomPropertyFilesUpdateCustomPropertyFileResponse>;

Параметры пути

ПолеТипОбязательность
card_uidstring (uuid)Обязательно
property_uidstring (uuid)Обязательно
idstring (uuid)Обязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
namestringНеобязательно
card_coverbooleanНеобязательно

Ответ: Объект. Поля: id, name, size, mime_type, author_uid, card_uid, custom_property_uid, company_uid, entity_type, created, updated, card_cover.

serviceDeskServices ​

retrieveServicesList ​

client.serviceDeskServices.retrieveServicesList · GET /api/latest/service-desk/services

Retrieve services list. Документация Kaiten.

...args: ServiceDeskServicesRetrieveServicesListParams

ts
declare const retrieveServicesList: (
  options?: OperationOptions,
) => Promise<ServiceDeskServicesRetrieveServicesListResponse>;

Параметры пути

нет.

Параметры запроса

нет.

Ответ: Массив. Поля: id, name, fields_settings, archived, lng, email_settings, type_id, email_key, board_id, column_id, lane_id, display_status, template_description, settings, allow_to_add_external_recipients, column, board, lane, voteCustomProperty.

spaceBoards ​

createNewBoard ​

client.spaceBoards.createNewBoard · POST /api/latest/spaces/{space_id}/boards

Create new board. Документация Kaiten.

...args: SpaceBoardsCreateNewBoardParams

ts
declare const createNewBoard: (
  spaceId: number,
  body: SpaceBoardsCreateNewBoardBody,
  options?: OperationOptions,
) => Promise<SpaceBoardsCreateNewBoardResponse>;

Параметры пути

ПолеТипОбязательность
space_idintegerОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
titlestring | numberОбязательно
columnsarray of objectНеобязательно
lanesarray of objectНеобязательно
descriptionstring | nullНеобязательно
topintegerНеобязательно
leftintegerНеобязательно
default_card_type_idintegerНеобязательно
first_image_is_coverbooleanНеобязательно
reset_lane_spent_timebooleanНеобязательно
automove_cardsbooleanНеобязательно
backward_moves_enabledbooleanНеобязательно
auto_assign_enabledbooleanНеобязательно
sort_ordernumberНеобязательно
external_idnumber | string | nullНеобязательно

Ответ: Объект. Поля: created, updated, id, title, cell_wip_limits, external_id, default_card_type_id, description, email_key, move_parents_to_done, default_tags, first_image_is_cover, reset_lane_spent_time, backward_moves_enabled, hide_done_policies, hide_done_policies_in_done_column, automove_cards, auto_assign_enabled, card_properties, columns, lanes, top, left, sort_order.

getBoard ​

client.spaceBoards.getBoard · GET /api/latest/spaces/{space_id}/boards/{id}

Get board. Документация Kaiten.

...args: SpaceBoardsGetBoardParams

ts
declare const getBoard: (
  spaceId: number,
  id: number,
  options?: OperationOptions,
) => Promise<SpaceBoardsGetBoardResponse>;

Параметры пути

ПолеТипОбязательность
space_idintegerОбязательно
idintegerОбязательно

Параметры запроса

нет.

Ответ: Объект. Поля: created, updated, id, title, cell_wip_limits, default_card_type_id, description, external_id, email_key, move_parents_to_done, backward_moves_enabled, default_tags, first_image_is_cover, reset_lane_spent_time, automove_cards, hide_done_policies, hide_done_policies_in_done_column, auto_assign_enabled, card_properties, columns, lanes, cards, space_id, board_id, top, left, sort_order.

getListOfBoards ​

client.spaceBoards.getListOfBoards · GET /api/latest/spaces/{space_id}/boards

Get list of boards. Документация Kaiten.

...args: SpaceBoardsGetListOfBoardsParams

ts
declare const getListOfBoards: (
  spaceId: number,
  options?: OperationOptions,
) => Promise<SpaceBoardsGetListOfBoardsResponse>;

Параметры пути

ПолеТипОбязательность
space_idintegerОбязательно

Параметры запроса

нет.

Ответ: Массив. Поля: created, updated, id, title, cell_wip_limits, external_id, default_card_type_id, description, email_key, move_parents_to_done, default_tags, first_image_is_cover, reset_lane_spent_time, backward_moves_enabled, hide_done_policies, hide_done_policies_in_done_column, automove_cards, auto_assign_enabled, card_properties, columns, lanes, space_id, board_id, top, left, sort_order, type.

removeBoard ​

client.spaceBoards.removeBoard · DELETE /api/latest/spaces/{space_id}/boards/{id}

Remove board. Документация Kaiten.

...args: SpaceBoardsRemoveBoardParams

ts
declare const removeBoard: (
  spaceId: number,
  id: number,
  force?: boolean,
  options?: OperationOptions,
) => Promise<SpaceBoardsRemoveBoardResponse>;

Параметры пути

ПолеТипОбязательность
space_idintegerОбязательно
idintegerОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
forcebooleanНеобязательно

Ответ: Объект. Поля: id.

updateBoard ​

client.spaceBoards.updateBoard · PATCH /api/latest/spaces/{space_id}/boards/{id}

Update board. Документация Kaiten.

...args: SpaceBoardsUpdateBoardParams

ts
declare const updateBoard: (
  spaceId: number,
  id: number,
  body: SpaceBoardsUpdateBoardBody,
  options?: OperationOptions,
) => Promise<SpaceBoardsUpdateBoardResponse>;

Параметры пути

ПолеТипОбязательность
space_idintegerОбязательно
idintegerОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
titlestring | numberНеобязательно
descriptionstring | nullНеобязательно
topintegerНеобязательно
leftintegerНеобязательно
type1 | 5Необязательно
cell_wip_limitsarray of unknownНеобязательно
default_card_type_idintegerНеобязательно
default_tagsstring | nullНеобязательно
first_image_is_coverbooleanНеобязательно
reset_lane_spent_timebooleanНеобязательно
automove_cardsbooleanНеобязательно
backward_moves_enabledbooleanНеобязательно
move_parents_to_donebooleanНеобязательно
hide_done_policiesbooleanНеобязательно
hide_done_policies_in_done_columnbooleanНеобязательно
sort_ordernumberНеобязательно
external_idnumber | string | nullНеобязательно
move_from_space_idintegerНеобязательно
auto_assign_enabledbooleanНеобязательно
card_propertiesarray of object | nullНеобязательно

Ответ: Объект. Поля: created, updated, id, title, cell_wip_limits, external_id, default_card_type_id, description, email_key, move_parents_to_done, default_tags, first_image_is_cover, reset_lane_spent_time, backward_moves_enabled, hide_done_policies, hide_done_policies_in_done_column, automove_cards, auto_assign_enabled, card_properties, columns, lanes, top, left, sort_order.

spaceTemplateChecklistItems ​

createNewSpaceTemplateChecklistItem ​

client.spaceTemplateChecklistItems.createNewSpaceTemplateChecklistItem · POST /api/latest/spaces/{space_uid}/template-checklists/{template_checklist_uid}/items

Create new space template checklist item. Документация Kaiten.

...args: SpaceTemplateChecklistItemsCreateNewSpaceTemplateChecklistItemParams

ts
declare const createNewSpaceTemplateChecklistItem: (
  spaceUid: string,
  templateChecklistUid: string,
  text: string,
  sortOrder?: number,
  options?: OperationOptions,
) => Promise<SpaceTemplateChecklistItemsCreateNewSpaceTemplateChecklistItemResponse>;

Параметры пути

ПолеТипОбязательность
space_uidstringОбязательно
template_checklist_uidstringОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
textstringОбязательно
sort_ordernumberНеобязательно

Ответ: Объект. Поля: uid, text, sort_order, user_id, created, updated.

removeSpaceTemplateChecklistItem ​

client.spaceTemplateChecklistItems.removeSpaceTemplateChecklistItem · DELETE /api/latest/spaces/{space_uid}/template-checklists/{template_checklist_uid}/items/{item_uid}

Remove space template checklist item. Документация Kaiten.

...args: SpaceTemplateChecklistItemsRemoveSpaceTemplateChecklistItemParams

ts
declare const removeSpaceTemplateChecklistItem: (
  spaceUid: string,
  templateChecklistUid: string,
  itemUid: string,
  options?: OperationOptions,
) => Promise<SpaceTemplateChecklistItemsRemoveSpaceTemplateChecklistItemResponse>;

Параметры пути

ПолеТипОбязательность
space_uidstringОбязательно
template_checklist_uidstringОбязательно
item_uidstringОбязательно

Параметры запроса

нет.

Ответ: Объект. Поля: uid.

updateSpaceTemplateChecklistItem ​

client.spaceTemplateChecklistItems.updateSpaceTemplateChecklistItem · PATCH /api/latest/spaces/{space_uid}/template-checklists/{template_checklist_uid}/items/{item_uid}

Update space template checklist item. Документация Kaiten.

...args: SpaceTemplateChecklistItemsUpdateSpaceTemplateChecklistItemParams

ts
declare const updateSpaceTemplateChecklistItem: (
  spaceUid: string,
  templateChecklistUid: string,
  itemUid: string,
  body: SpaceTemplateChecklistItemsUpdateSpaceTemplateChecklistItemBody,
  options?: OperationOptions,
) => Promise<SpaceTemplateChecklistItemsUpdateSpaceTemplateChecklistItemResponse>;

Параметры пути

ПолеТипОбязательность
space_uidstringОбязательно
template_checklist_uidstringОбязательно
item_uidstringОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
textstringНеобязательно
sort_ordernumberНеобязательно

Ответ: Объект. Поля: uid, text, sort_order, user_id, created, updated.

spaceTemplateChecklist ​

createNewSpaceTemplateChecklist ​

client.spaceTemplateChecklist.createNewSpaceTemplateChecklist · POST /api/latest/spaces/{space_uid}/template-checklists

Create new space template checklist. Документация Kaiten.

...args: SpaceTemplateChecklistCreateNewSpaceTemplateChecklistParams

ts
declare const createNewSpaceTemplateChecklist: (
  spaceUid: string,
  name: string,
  sortOrder?: number,
  options?: OperationOptions,
) => Promise<SpaceTemplateChecklistCreateNewSpaceTemplateChecklistResponse>;

Параметры пути

ПолеТипОбязательность
space_uidstringОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
namestringНеобязательно
sort_ordernumberНеобязательно

Ответ: Объект. Поля: uid, name, sort_order, space_uid, created, updated.

getListOfSpaceTemplateChecklists ​

client.spaceTemplateChecklist.getListOfSpaceTemplateChecklists · GET /api/latest/spaces/{space_uid}/template-checklists

Get list of space template checklists. Документация Kaiten.

...args: SpaceTemplateChecklistGetListOfSpaceTemplateChecklistsParams

ts
declare const getListOfSpaceTemplateChecklists: (
  spaceUid: string,
  options?: OperationOptions,
) => Promise<SpaceTemplateChecklistGetListOfSpaceTemplateChecklistsResponse>;

Параметры пути

ПолеТипОбязательность
space_uidstringОбязательно

Параметры запроса

нет.

Ответ: Массив. Поля: uid, name, sort_order, space_uid, created, updated, items.

removeSpaceTemplateChecklist ​

client.spaceTemplateChecklist.removeSpaceTemplateChecklist · DELETE /api/latest/spaces/{space_uid}/template-checklists/{template_checklist_uid}

Remove space template checklist. Документация Kaiten.

...args: SpaceTemplateChecklistRemoveSpaceTemplateChecklistParams

ts
declare const removeSpaceTemplateChecklist: (
  spaceUid: string,
  templateChecklistUid: string,
  options?: OperationOptions,
) => Promise<SpaceTemplateChecklistRemoveSpaceTemplateChecklistResponse>;

Параметры пути

ПолеТипОбязательность
space_uidstringОбязательно
template_checklist_uidstringОбязательно

Параметры запроса

нет.

Ответ: Объект. Поля: uid.

updateSpaceTemplateChecklist ​

client.spaceTemplateChecklist.updateSpaceTemplateChecklist · PATCH /api/latest/spaces/{space_uid}/template-checklists/{template_checklist_uid}

Update space template checklist. Документация Kaiten.

...args: SpaceTemplateChecklistUpdateSpaceTemplateChecklistParams

ts
declare const updateSpaceTemplateChecklist: (
  spaceUid: string,
  templateChecklistUid: string,
  body: SpaceTemplateChecklistUpdateSpaceTemplateChecklistBody,
  options?: OperationOptions,
) => Promise<SpaceTemplateChecklistUpdateSpaceTemplateChecklistResponse>;

Параметры пути

ПолеТипОбязательность
space_uidstringОбязательно
template_checklist_uidstringОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
namestringНеобязательно
sort_ordernumberНеобязательно
space_uidstringНеобязательно

Ответ: Объект. Поля: uid, name, sort_order, space_uid, created, updated.

spaceUsers ​

changeUserRoleAndNotificationSettings ​

client.spaceUsers.changeUserRoleAndNotificationSettings · PATCH /api/latest/spaces/{space_id}/users/{id}

Change user role and notification settings. Документация Kaiten.

...args: SpaceUsersChangeUserRoleAndNotificationSettingsParams

ts
declare const changeUserRoleAndNotificationSettings: (
  spaceId: number,
  id: number,
  body: SpaceUsersChangeUserRoleAndNotificationSettingsBody,
  options?: OperationOptions,
) => Promise<SpaceUsersChangeUserRoleAndNotificationSettingsResponse>;

Параметры пути

ПолеТипОбязательность
space_idintegerОбязательно
idintegerОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
role_idstringНеобязательно
notifications_enabledbooleanНеобязательно
space_group_idnumber | nullНеобязательно
settingsobjectНеобязательно

Ответ: Объект. Поля: entity_uid, access_mod, own_role_ids, own_access_mod, own_role, user_id, id.

getListOfUsers ​

client.spaceUsers.getListOfUsers · GET /api/latest/spaces/{space_id}/users

Get list of users. Документация Kaiten.

...args: SpaceUsersGetListOfUsersParams

ts
declare const getListOfUsers: (
  spaceId: number,
  query?: SpaceUsersGetListOfUsersQuery,
  options?: OperationOptions,
) => Promise<SpaceUsersGetListOfUsersResponse>;

Параметры пути

ПолеТипОбязательность
space_idintegerОбязательно

Параметры запроса

ПолеТипОбязательность
include_inherited_accessbooleanНеобязательно
inactivebooleanНеобязательно
limitintegerНеобязательно
last_user_idintegerНеобязательно

Ответ: Массив. Поля: id, full_name, email, username, avatar_initials_url, avatar_uploaded_url, initials, avatar_type, lng, timezone, theme, created, updated, activated, ui_version, virtual, apps_permissions, temporarily_inactive, access_mod, own_role_ids, own_access_mod, own_role, current.

getUser ​

client.spaceUsers.getUser · GET /api/latest/spaces/{space_id}/users/{id}

Get user. Документация Kaiten.

...args: SpaceUsersGetUserParams

ts
declare const getUser: (
  spaceId: number,
  id: number,
  options?: OperationOptions,
) => Promise<SpaceUsersGetUserResponse>;

Параметры пути

ПолеТипОбязательность
space_idintegerОбязательно
idintegerОбязательно

Параметры запроса

нет.

Ответ: Объект. Поля: id, full_name, email, username, avatar_initials_url, avatar_uploaded_url, initials, avatar_type, lng, timezone, theme, created, updated, activated, ui_version, virtual, entity_uid, user_id, access_mod.

inviteUserToSpace ​

client.spaceUsers.inviteUserToSpace · POST /api/latest/spaces/{space_id}/users

Invite user to space. Документация Kaiten.

...args: SpaceUsersInviteUserToSpaceParams

ts
declare const inviteUserToSpace: (
  spaceId: number,
  body: SpaceUsersInviteUserToSpaceBody,
  options?: OperationOptions,
) => Promise<SpaceUsersInviteUserToSpaceResponse>;

Параметры пути

ПолеТипОбязательность
space_idintegerОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
emailstringОбязательно
role_idstringНеобязательно
guestbooleanНеобязательно
operator_commentstringНеобязательно
send_emailbooleanНеобязательно

Ответ: Объект. Поля: user, access_record, message.

removeUserFromSpace ​

client.spaceUsers.removeUserFromSpace · DELETE /api/latest/spaces/{space_id}/users/{id}

Remove user from space. Документация Kaiten.

...args: SpaceUsersRemoveUserFromSpaceParams

ts
declare const removeUserFromSpace: (
  spaceId: number,
  id: number,
  options?: OperationOptions,
) => Promise<SpaceUsersRemoveUserFromSpaceResponse>;

Параметры пути

ПолеТипОбязательность
space_idintegerОбязательно
idintegerОбязательно

Параметры запроса

нет.

Ответ: Объект. Поля: entity_uid, access_mod, own_role_ids, own_access_mod, own_role, user_id.

spaces ​

createNewSpace ​

client.spaces.createNewSpace · POST /api/latest/spaces

Create new space. Документация Kaiten.

...args: SpacesCreateNewSpaceParams

ts
declare const createNewSpace: (
  body: SpacesCreateNewSpaceBody,
  options?: OperationOptions,
) => Promise<SpacesCreateNewSpaceResponse>;

Параметры пути

нет.

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
titlestring | numberОбязательно
external_idnumber | string | nullНеобязательно
parent_entity_uidstringНеобязательно
for_everyone_access_role_idstringНеобязательно
sort_ordernumberНеобязательно
work_calendar_idstringНеобязательно

Ответ: Объект. Поля: created, updated, archived, uid, access, for_everyone_access_role_id, entity_type, path, sort_order, parent_entity_uid, company_id, id, title, allowed_card_type_ids, hidden_card_type_uids, external_id, settings, users.

removeSpace ​

client.spaces.removeSpace · DELETE /api/latest/spaces/{space_id}

Remove space. Документация Kaiten.

...args: SpacesRemoveSpaceParams

ts
declare const removeSpace: (
  spaceId: number,
  options?: OperationOptions,
) => Promise<SpacesRemoveSpaceResponse>;

Параметры пути

ПолеТипОбязательность
space_idintegerОбязательно

Параметры запроса

нет.

Ответ: Объект. Поля: id.

retrieveListOfSpaces ​

client.spaces.retrieveListOfSpaces · GET /api/latest/spaces

Retrieve list of spaces. Документация Kaiten.

...args: SpacesRetrieveListOfSpacesParams

ts
declare const retrieveListOfSpaces: (
  limit?: number,
  offset?: number,
  options?: OperationOptions,
) => Promise<SpacesRetrieveListOfSpacesResponse>;

Параметры пути

нет.

Параметры запроса

ПолеТипОбязательность
limitintegerНеобязательно
offsetintegerНеобязательно

Ответ: Массив. Поля: created, updated, archived, uid, access, for_everyone_access_role_id, entity_type, path, sort_order, parent_entity_uid, company_id, id, title, allowed_card_type_ids, hidden_card_type_uids, external_id, settings, boards, user_id, entity_uid, access_mod.

retrieveSpace ​

client.spaces.retrieveSpace · GET /api/latest/spaces/{space_id}

Retrieve space. Документация Kaiten.

...args: SpacesRetrieveSpaceParams

ts
declare const retrieveSpace: (
  spaceId: number,
  options?: OperationOptions,
) => Promise<SpacesRetrieveSpaceResponse>;

Параметры пути

ПолеТипОбязательность
space_idintegerОбязательно

Параметры запроса

нет.

Ответ: Объект. Поля: created, updated, archived, uid, for_everyone_access_role_id, access, entity_type, path, sort_order, parent_entity_uid, company_id, id, title, allowed_card_type_ids, hidden_card_type_uids, external_id, settings.

updateSpace ​

client.spaces.updateSpace · PATCH /api/latest/spaces/{space_id}

Update space. Документация Kaiten.

...args: SpacesUpdateSpaceParams

ts
declare const updateSpace: (
  spaceId: number,
  body: SpacesUpdateSpaceBody,
  options?: OperationOptions,
) => Promise<SpacesUpdateSpaceResponse>;

Параметры пути

ПолеТипОбязательность
space_idintegerОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
titlestring | numberНеобязательно
external_idnumber | string | nullНеобязательно
hidden_card_type_uidsarray of stringНеобязательно
settingsobjectНеобязательно
accessfor_everyone | by_inviteНеобязательно
parent_entity_uidstring | nullНеобязательно
sort_ordernumberНеобязательно

Ответ: Объект. Поля: created, updated, archived, uid, for_everyone_access_role_id, access, entity_type, path, sort_order, parent_entity_uid, company_id, id, title, allowed_card_type_ids, hidden_card_type_uids, external_id, settings.

sprints ​

getSprintSummary ​

client.sprints.getSprintSummary · GET /api/latest/sprints/{id}

Get sprint summary. Документация Kaiten.

...args: SprintsGetSprintSummaryParams

ts
declare const getSprintSummary: (
  id: number,
  excludeDeletedCards?: boolean,
  options?: OperationOptions,
) => Promise<SprintsGetSprintSummaryResponse>;

Параметры пути

ПолеТипОбязательность
idintegerОбязательно

Параметры запроса

ПолеТипОбязательность
exclude_deleted_cardsbooleanНеобязательно

Ответ: Объект. Поля: created, updated, archived, id, uid, board_id, title, goal, active, committed, children_committed, velocity, velocity_details, children_velocity, children_velocity_details, creator_id, updater_id, start_date, finish_date, actual_finish_date, cards, cardUpdates, customProperties.

getSprintsList ​

client.sprints.getSprintsList · GET /api/latest/sprints

Get sprints list. Документация Kaiten.

...args: SprintsGetSprintsListParams

ts
declare const getSprintsList: (
  active?: boolean,
  limit?: number,
  offset?: number,
  options?: OperationOptions,
) => Promise<SprintsGetSprintsListResponse>;

Параметры пути

нет.

Параметры запроса

ПолеТипОбязательность
activebooleanНеобязательно
limitintegerНеобязательно
offsetintegerНеобязательно

Ответ: Массив. Поля: id, uid, board_id, title, goal, active, committed, children_committed, velocity, velocity_details, children_velocity, children_velocity_details, creator_id, updater_id, start_date, finish_date, actual_finish_date, created, updated, archived.

subcolumn ​

createNewSubcolumn ​

client.subcolumn.createNewSubcolumn · POST /api/latest/columns/{column_id}/subcolumns

Create new subcolumn. Документация Kaiten.

...args: SubcolumnCreateNewSubcolumnParams

ts
declare const createNewSubcolumn: (
  columnId: number,
  body: SubcolumnCreateNewSubcolumnBody,
  options?: OperationOptions,
) => Promise<SubcolumnCreateNewSubcolumnResponse>;

Параметры пути

ПолеТипОбязательность
column_idintegerОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
external_idnumber | string | nullНеобязательно
titlestringОбязательно
sort_ordernumberНеобязательно
type1 | 2 | 3Необязательно
archive_after_daysintegerНеобязательно
months_to_hide_cardsinteger | nullНеобязательно
card_hide_after_daysinteger | nullНеобязательно
col_countintegerНеобязательно
rulesintegerНеобязательно
last_moved_warning_after_minutesintegerНеобязательно
last_moved_warning_after_hoursintegerНеобязательно
last_moved_warning_after_daysintegerНеобязательно

Ответ: Объект. Поля: created, updated, id, title, sort_order, col_count, wip_limit, wip_limit_type, type, rules, board_id, column_id, archive_after_days, last_moved_warning_after_minutes, last_moved_warning_after_days, last_moved_warning_after_hours, external_id, default_tags, months_to_hide_cards, card_hide_after_days.

getListOfSubcolumns ​

client.subcolumn.getListOfSubcolumns · GET /api/latest/columns/{column_id}/subcolumns

Get list of subcolumns. Документация Kaiten.

...args: SubcolumnGetListOfSubcolumnsParams

ts
declare const getListOfSubcolumns: (
  columnId: number,
  options?: OperationOptions,
) => Promise<SubcolumnGetListOfSubcolumnsResponse>;

Параметры пути

ПолеТипОбязательность
column_idintegerОбязательно

Параметры запроса

нет.

Ответ: Массив. Поля: created, updated, id, title, sort_order, col_count, wip_limit, type, rules, board_id, column_id, archive_after_days, wip_limit_type, external_id, default_tags, last_moved_warning_after_days, months_to_hide_cards, card_hide_after_days, last_moved_warning_after_hours, last_moved_warning_after_minutes.

removeSubcolumn ​

client.subcolumn.removeSubcolumn · DELETE /api/latest/columns/{column_id}/subcolumns/{id}

Remove subcolumn. Документация Kaiten.

...args: SubcolumnRemoveSubcolumnParams

ts
declare const removeSubcolumn: (
  columnId: number,
  subcolumnId: number,
  force?: boolean,
  options?: OperationOptions,
) => Promise<SubcolumnRemoveSubcolumnResponse>;

Параметры пути

ПолеТипОбязательность
column_idintegerОбязательно
idintegerОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
forcebooleanНеобязательно

Ответ: Объект. Поля: id.

updateSubcolumn ​

client.subcolumn.updateSubcolumn · PATCH /api/latest/columns/{column_id}/subcolumns/{id}

Update subcolumn. Документация Kaiten.

...args: SubcolumnUpdateSubcolumnParams

ts
declare const updateSubcolumn: (
  columnId: number,
  subcolumnId: number,
  body: SubcolumnUpdateSubcolumnBody,
  options?: OperationOptions,
) => Promise<SubcolumnUpdateSubcolumnResponse>;

Параметры пути

ПолеТипОбязательность
column_idintegerОбязательно
idintegerОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
external_idnumber | string | nullНеобязательно
titlestringНеобязательно
sort_ordernumberНеобязательно
type1 | 2 | 3Необязательно
archive_after_daysintegerНеобязательно
months_to_hide_cardsinteger | nullНеобязательно
card_hide_after_daysinteger | nullНеобязательно
col_countintegerНеобязательно
rulesintegerНеобязательно
default_tagsstring | nullНеобязательно
last_moved_warning_after_minutesintegerНеобязательно
last_moved_warning_after_hoursintegerНеобязательно
last_moved_warning_after_daysintegerНеобязательно
prev_column_idinteger | nullНеобязательно
next_column_idinteger | nullНеобязательно
pause_slabooleanНеобязательно

Ответ: Объект. Поля: created, updated, id, title, sort_order, col_count, wip_limit, wip_limit_type, type, rules, board_id, column_id, archive_after_days, last_moved_warning_after_minutes, last_moved_warning_after_days, last_moved_warning_after_hours, external_id, default_tags, months_to_hide_cards, card_hide_after_days.

tags ​

addTag ​

client.tags.addTag · POST /api/latest/tags

Add tag. Документация Kaiten.

...args: TagsAddTagParams

ts
declare const addTag: (
  name: string,
  query?: TagsAddTagQuery,
  options?: OperationOptions,
) => Promise<TagsAddTagResponse>;

Параметры пути

нет.

Параметры запроса

ПолеТипОбязательность
idsstringНеобязательно
querystringНеобязательно
space_idintegerНеобязательно
limitintegerНеобязательно
offsetintegerНеобязательно

Тело запроса

ПолеТипОбязательность
namestringОбязательно

Ответ: Объект. Поля: created, updated, id, name, company_id, color, archived.

retrieveListOfTags ​

client.tags.retrieveListOfTags · GET /api/latest/tags

Клиент принимает ids как строку или readonly-массив чисел (QueryList<number>).

Retrieve list of tags. Документация Kaiten.

...args: TagsRetrieveListOfTagsParams

ts
declare const retrieveListOfTags: (
  query?: TagsRetrieveListOfTagsQuery,
  options?: OperationOptions,
) => Promise<TagsRetrieveListOfTagsResponse>;

Параметры пути

нет.

Параметры запроса

ПолеТипОбязательность
limitintegerНеобязательно
offsetintegerНеобязательно
space_idintegerНеобязательно
idsstringНеобязательно
querystringНеобязательно

Ответ: Массив. Поля: created, updated, id, name, company_id, color, archived.

timesheet ​

getList ​

client.timesheet.getList · GET /api/latest/time-logs

Клиент принимает восемь фильтров ID со списками через запятую как строки или readonly-массивы чисел (QueryList<number>).

Get list. Документация Kaiten.

...args: TimesheetGetListParams

ts
declare const getList: (
  query: TimesheetGetListQuery,
  options?: OperationOptions,
) => Promise<TimesheetGetListResponse>;

Параметры пути

нет.

Параметры запроса

ПолеТипОбязательность
fromstringОбязательно
tostringОбязательно
tag_idsstringНеобязательно
user_idsstringНеобязательно
group_idsstringНеобязательно
space_idsstringНеобязательно
board_idsstringНеобязательно
column_idsstringНеобязательно
card_idsstringНеобязательно
visible_column_idsstringНеобязательно
limitintegerНеобязательно
offsetintegerНеобязательно
conditionintegerНеобязательно
group_byintegerНеобязательно
time_precisionintegerНеобязательно
time_unitintegerНеобязательно
with_daily_distributionintegerНеобязательно
only_general_sumintegerНеобязательно

Ответ: Массив. Поля: created, updated, id, card_id, user_id, role_id, author_id, updater_id, time_spent, for_date, comment, card, user, role.

treeEntities ​

getListOfEntities ​

client.treeEntities.getListOfEntities · GET /api/latest/tree-entities

Get list of entities. Документация Kaiten. Beta.

...args: TreeEntitiesGetListOfEntitiesParams

ts
declare const getListOfEntities: (
  query?: TreeEntitiesGetListOfEntitiesQuery,
  options?: OperationOptions,
) => Promise<TreeEntitiesGetListOfEntitiesResponse>;

Параметры пути

нет.

Параметры запроса

ПолеТипОбязательность
limitnumberНеобязательно
offsetnumberНеобязательно
parent_entity_uidstringНеобязательно
levels_countnumberНеобязательно

Ответ: Массив. Поля: id, uid, title, external_id, company_id, sort_order, path, parent_entity_uid, entity_type, access, archived, for_everyone_access_role_id.

treeEntityRoles ​

getListOfTreeEntityRoles ​

client.treeEntityRoles.getListOfTreeEntityRoles · GET /api/latest/tree-entity-roles

Get list of tree entity roles. Документация Kaiten. Beta.

...args: TreeEntityRolesGetListOfTreeEntityRolesParams

ts
declare const getListOfTreeEntityRoles: (
  options?: OperationOptions,
) => Promise<TreeEntityRolesGetListOfTreeEntityRolesResponse>;

Параметры пути

нет.

Параметры запроса

нет.

Ответ: Массив. Поля: id, name, permissions, sort_order, new_permissions_default_value, updated, created.

userRoles ​

createUserRole ​

client.userRoles.createUserRole · POST /api/latest/user-roles

Create user role. Документация Kaiten.

...args: UserRolesCreateUserRoleParams

ts
declare const createUserRole: (
  name: string,
  options?: OperationOptions,
) => Promise<UserRolesCreateUserRoleResponse>;

Параметры пути

нет.

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
namestringОбязательно

Ответ: Объект. Поля: name, company_id, updated, created, id, uid.

getListOfUserRoles ​

client.userRoles.getListOfUserRoles · GET /api/latest/user-roles

Get list of user roles. Документация Kaiten.

...args: UserRolesGetListOfUserRolesParams

ts
declare const getListOfUserRoles: (
  options?: OperationOptions,
) => Promise<UserRolesGetListOfUserRolesResponse>;

Параметры пути

нет.

Параметры запроса

нет.

Ответ: Массив. Поля: created, updated, id, uid, name, company_id.

getUserRole ​

client.userRoles.getUserRole · GET /api/latest/user-roles/{role_id}

Get user role. Документация Kaiten.

...args: UserRolesGetUserRoleParams

ts
declare const getUserRole: (
  roleId: number,
  options?: OperationOptions,
) => Promise<UserRolesGetUserRoleResponse>;

Параметры пути

ПолеТипОбязательность
role_idintegerОбязательно

Параметры запроса

нет.

Ответ: Объект. Поля: name, company_id, updated, created, id, uid.

removeUserRole ​

client.userRoles.removeUserRole · DELETE /api/latest/user-roles/{role_id}

Remove user role. Документация Kaiten.

...args: UserRolesRemoveUserRoleParams

ts
declare const removeUserRole: (
  roleId: number,
  replaceRoleId: number,
  options?: OperationOptions,
) => Promise<UserRolesRemoveUserRoleResponse>;

Параметры пути

ПолеТипОбязательность
role_idintegerОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
replace_role_idintegerОбязательно

Ответ: Объект. Поля: name, company_id, updated, created, id, uid.

updateUserRole ​

client.userRoles.updateUserRole · PATCH /api/latest/user-roles/{role_id}

Update user role. Документация Kaiten.

...args: UserRolesUpdateUserRoleParams

ts
declare const updateUserRole: (
  roleId: number,
  name: string,
  options?: OperationOptions,
) => Promise<UserRolesUpdateUserRoleResponse>;

Параметры пути

ПолеТипОбязательность
role_idintegerОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
namestringОбязательно

Ответ: Объект. Поля: name, company_id, updated, created, id, uid.

users ​

retrieveCurrentUser ​

client.users.retrieveCurrentUser · GET /api/latest/users/current

Retrieve current user. Документация Kaiten.

...args: UsersRetrieveCurrentUserParams

ts
declare const retrieveCurrentUser: (
  options?: OperationOptions,
) => Promise<UsersRetrieveCurrentUserResponse>;

Параметры пути

нет.

Параметры запроса

нет.

Ответ: Объект. Поля: id, full_name, email, username, avatar_initials_url, avatar_uploaded_url, initials, avatar_type, lng, timezone, theme, created, updated, activated, ui_version, company_id, telegram_id, telegram_settings, user_id, default_space_id, permissions, role, email_frequency, email_settings, slack_id, slack_settings, notification_settings, notification_enabled_channels, slack_private_channel_id, telegram_sd_bot_enabled, invite_last_sent_at, apps_permissions, external, last_request_date, last_request_method, has_password.

retrieveListOfUsers ​

client.users.retrieveListOfUsers · GET /api/latest/users

Клиент принимает ids как строку или readonly-массив чисел (QueryList<number>).

Retrieve list of users. Документация Kaiten.

...args: UsersRetrieveListOfUsersParams

ts
declare const retrieveListOfUsers: (
  query?: UsersRetrieveListOfUsersQuery,
  options?: OperationOptions,
) => Promise<UsersRetrieveListOfUsersResponse>;

Параметры пути

нет.

Параметры запроса

ПолеТипОбязательность
typestringНеобязательно
querystringНеобязательно
access_type_permissionsstringНеобязательно
idsstringНеобязательно
limitintegerНеобязательно
offsetintegerНеобязательно
include_inactivebooleanНеобязательно
exclude_directly_added_members_by_entity_uidstringНеобязательно
exclude_members_by_entity_uidstringНеобязательно

Ответ: Массив. Поля: id, full_name, email, username, avatar_initials_url, avatar_uploaded_url, initials, avatar_type, lng, timezone, theme, created, updated, activated, ui_version, company_id, user_id, default_space_id, permissions, role, email_frequency, email_settings, slack_id, slack_settings, notification_settings, notification_enabled_channels, slack_private_channel_id, telegram_sd_bot_enabled, invite_last_sent_at, apps_permissions, external, last_request_date, last_request_method.

updateUser ​

client.users.updateUser · PATCH /api/latest/users/{id}

Update user. Документация Kaiten.

...args: UsersUpdateUserParams

ts
declare const updateUser: (
  userId: number,
  body: UsersUpdateUserBody,
  options?: OperationOptions,
) => Promise<UsersUpdateUserResponse>;

Параметры пути

ПолеТипОбязательность
idintegerОбязательно

Параметры запроса

нет.

Тело запроса

ПолеТипОбязательность
usernamestringНеобязательно
full_namestringНеобязательно
initialsstringНеобязательно
avatar_type1 | 2 | 3Необязательно
passwordstringНеобязательно
old_passwordstring | nullНеобязательно
lngstringНеобязательно
default_space_idinteger | nullНеобязательно
themelight | dark | autoНеобязательно
email_frequency1 | 2Необязательно
timezonestringНеобязательно
subject_by1 | 2Необязательно
email_settingsobjectНеобязательно
telegram_settingsobjectНеобязательно
slack_settingsobjectНеобязательно
notification_enabled_channelsarray of inner | mobile_app | email | slack | telegramНеобязательно
notification_settingsobjectНеобязательно
ui_version1 | 2Необязательно

Ответ: Объект. Поля: created, updated, id, full_name, username, email, activated, show_tour, avatar_initials_url, avatar_uploaded_url, initials, avatar_type, lng, sd_telegram_id, timezone, news_subscription, theme, ui_version, default_space_id, email_frequency, email_settings, work_time_settings, telegram_id, telegram_settings, has_password.