Skip to content

REST API: all operations ​

Operations are grouped by client resource. Method and type names match the package exports. Use your editor for nested fields and exact TypeScript types. Each entry links to the original Kaiten documentation.

cards.iterate, documents.iterate, and documentGroups.iterate provide automatic pagination over the corresponding search operations. See the pagination and typed filter guide.

users.iterate and tags.iterate traverse their lists with offset pagination. See users and tags.

Paths below use the version shown in Kaiten's documentation. The REST client defaults to /api/v1; apiVersion: "latest" switches the prefix to /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 documentation.

...args: AuditLogsRetrieveAuditLogEventsParams

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

Path parameters

none.

Query parameters

FieldTypePresence
fromstringOptional
tostringOptional
author_idintegerOptional
author_uidstringOptional
categoriesstringOptional
actionsstringOptional
idstringOptional
limitintegerOptional
offsetintegerOptional

Response: Array. Fields: 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 documentation.

...args: AutomationsCreateAutomationParams

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

Path parameters

FieldTypePresence
space_idintegerRequired

Query parameters

none.

Request body

FieldTypePresence
typeon_action | on_date | on_demandRequired
namestringOptional
triggerAutomationTriggerOptional
conditionsAutomationConditionGroupOptional
actionsarray of AutomationActionRequired

Response: Object. Fields: 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 documentation.

...args: AutomationsDeleteAutomationParams

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

Path parameters

FieldTypePresence
space_idintegerRequired
automation_uidstringRequired

Query parameters

none.

Response: Object. Fields: message.

getListOfAutomations ​

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

Get list of automations. Kaiten documentation.

...args: AutomationsGetListOfAutomationsParams

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

Path parameters

FieldTypePresence
space_idintegerRequired

Query parameters

none.

Response: Array. Fields: 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 documentation.

...args: AutomationsUpdateAutomationParams

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

Path parameters

FieldTypePresence
space_idintegerRequired
automation_uidstringRequired

Query parameters

none.

Request body

FieldTypePresence
typeon_action | on_date | on_demandOptional
namestringOptional
triggerAutomationTriggerOptional
conditionsAutomationConditionGroupOptional
actionsarray of AutomationActionOptional

Response: Object. Fields: 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 documentation.

...args: BoardsGetBoardParams

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

Path parameters

FieldTypePresence
idintegerRequired

Query parameters

none.

Response: Object. Fields: 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 documentation.

...args: CardAllowedUsersRetrieveUsersListParams

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

Path parameters

FieldTypePresence
card_idintegerRequired

Query parameters

FieldTypePresence
typeenumOptional
searchstringOptional
orderBystringOptional
roleintegerOptional
limitintegerOptional
offsetintegerOptional

Response: Array. Fields: 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 documentation.

...args: CardBlockerCategoriesAddBlockerCategoryParams

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

Path parameters

FieldTypePresence
blocker_idintegerRequired

Query parameters

none.

Request body

FieldTypePresence
namestringRequired

Response: Object. Fields: uid, name, color.

removeCategory ​

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

Remove category. Kaiten documentation.

...args: CardBlockerCategoriesRemoveCategoryParams

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

Path parameters

FieldTypePresence
blocker_idintegerRequired
category_uuidstringRequired

Query parameters

none.

Response: Object. Fields: uid.

retrieveListOfCategories ​

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

Retrieve list of categories. Kaiten documentation.

...args: CardBlockerCategoriesRetrieveListOfCategoriesParams

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

Path parameters

none.

Query parameters

none.

Response: Array. Fields: uid, name, color.

cardBlockerUsers ​

addUserToTheCardBlocker ​

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

Add user to the card blocker. Kaiten documentation.

...args: CardBlockerUsersAddUserToTheCardBlockerParams

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

Path parameters

FieldTypePresence
blocker_idintegerRequired

Query parameters

none.

Request body

FieldTypePresence
user_idintegerRequired

Response: Object. Fields: 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 documentation.

...args: CardBlockerUsersRemoveUserParams

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

Path parameters

FieldTypePresence
blocker_idintegerRequired
user_idintegerRequired

Query parameters

none.

Response: Object. Fields: id.

retrieveBlockersCardsListOnCurrentUser ​

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

Retrieve blockers cards list on current user. Kaiten documentation.

...args: CardBlockerUsersRetrieveBlockersCardsListOnCurrentUserParams

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

Path parameters

none.

Query parameters

none.

Response: Object. Fields: blocked_cards, summary.

retrieveListOfUsers ​

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

Retrieve list of users. Kaiten documentation.

...args: CardBlockerUsersRetrieveListOfUsersParams

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

Path parameters

FieldTypePresence
blocker_idintegerRequired

Query parameters

none.

Response: Array. Fields: 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 documentation.

...args: CardBlockersBlockCardParams

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

Path parameters

FieldTypePresence
card_idintegerRequired

Query parameters

none.

Request body

FieldTypePresence
reasonstringOptional
blocker_card_idintegerOptional

Response: Object. Fields: 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 documentation.

...args: CardBlockersDeleteCardBlockersParams

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

Path parameters

FieldTypePresence
card_idintegerRequired
idintegerRequired

Query parameters

none.

Response: Object. Fields: 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 documentation.

...args: CardBlockersRetrieveCardBlockersListParams

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

Path parameters

FieldTypePresence
card_idintegerRequired

Query parameters

none.

Response: Array. Fields: 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 documentation.

...args: CardBlockersUpdateCardBlockersParams

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

Path parameters

FieldTypePresence
card_idintegerRequired
idintegerRequired

Query parameters

none.

Request body

FieldTypePresence
reasonstringOptional
blocker_card_idintegerOptional
due_datestring | nullOptional
due_date_time_presentboolean | nullOptional

Response: Object. Fields: 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 documentation.

...args: CardChecklistItemsAddItemToChecklistParams

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

Path parameters

FieldTypePresence
card_idintegerRequired
checklist_idintegerRequired

Query parameters

none.

Request body

FieldTypePresence
textstringRequired
sort_ordernumberOptional
checkedbooleanOptional
due_datestring | nullOptional
responsible_idintegerOptional

Response: Object. Fields: 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 documentation.

...args: CardChecklistItemsRemoveChecklistItemParams

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

Path parameters

FieldTypePresence
card_idintegerRequired
checklist_idintegerRequired
idintegerRequired

Query parameters

none.

Response: Object. Fields: id.

updateChecklistItem ​

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

Update checklist item. Kaiten documentation.

...args: CardChecklistItemsUpdateChecklistItemParams

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

Path parameters

FieldTypePresence
card_idintegerRequired
checklist_idintegerRequired
idintegerRequired

Query parameters

none.

Request body

FieldTypePresence
textstring | nullOptional
sort_ordernumberOptional
checklist_idintegerOptional
checkedbooleanOptional
due_datestring | nullOptional
responsible_idnumber | nullOptional

Response: Object. Fields: 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 documentation.

...args: CardChecklistsAddChecklistToCardParams

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

Path parameters

FieldTypePresence
card_idintegerRequired

Query parameters

none.

Request body

FieldTypePresence
namestringOptional
sort_ordernumberOptional
items_source_checklist_idintegerOptional
exclude_item_idsarray of integerOptional
source_share_idintegerOptional

Response: Object. Fields: 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 documentation.

...args: CardChecklistsRemoveChecklistFromCardParams

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

Path parameters

FieldTypePresence
card_idintegerRequired
idintegerRequired

Query parameters

none.

Response: Object. Fields: id.

retrieveCardChecklist ​

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

Retrieve card checklist. Kaiten documentation.

...args: CardChecklistsRetrieveCardChecklistParams

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

Path parameters

FieldTypePresence
card_idintegerRequired
idintegerRequired

Query parameters

none.

Response: Object. Fields: 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 documentation.

...args: CardChecklistsUpdateChecklistParams

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

Path parameters

FieldTypePresence
card_idintegerRequired
idintegerRequired

Query parameters

none.

Request body

FieldTypePresence
namestringOptional
sort_ordernumberOptional
card_idintegerOptional

Response: Object. Fields: created, updated, id, name, policy_id.

cardChildren ​

addChildren ​

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

Add children. Kaiten documentation.

...args: CardChildrenAddChildrenParams

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

Path parameters

FieldTypePresence
card_idintegerRequired

Query parameters

none.

Request body

FieldTypePresence
card_idintegerRequired

Response: Object. Fields: 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 documentation.

...args: CardChildrenRemoveChildrenParams

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

Path parameters

FieldTypePresence
card_idintegerRequired
idintegerRequired

Query parameters

none.

Response: Object. Fields: id.

retrieveCardChildrenList ​

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

Retrieve card children list. Kaiten documentation.

...args: CardChildrenRetrieveCardChildrenListParams

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

Path parameters

FieldTypePresence
card_idintegerRequired

Query parameters

none.

Response: Array. Fields: 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 documentation.

...args: CardCommentsAddCommentParams

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

Path parameters

FieldTypePresence
card_idintegerRequired

Query parameters

none.

Request body

FieldTypePresence
textstringRequired
files[] Deprecatedarray of binary filesOptional

Response: Object. Fields: 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 documentation.

...args: CardCommentsRemoveCommentParams

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

Path parameters

FieldTypePresence
card_idintegerRequired
comment_idintegerRequired

Query parameters

none.

Response: Object. Fields: id.

retrieveCardComments ​

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

Retrieve card comments. Kaiten documentation.

...args: CardCommentsRetrieveCardCommentsParams

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

Path parameters

FieldTypePresence
card_idintegerRequired

Query parameters

none.

Response: Array. Fields: 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 documentation.

...args: CardCommentsUpdateCommentParams

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

Path parameters

FieldTypePresence
card_idintegerRequired
comment_idintegerRequired

Query parameters

none.

Request body

FieldTypePresence
textstringOptional
files[] Deprecatedarray of binary filesOptional

Response: Object. Fields: 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 documentation.

...args: CardExternalLinksAddExternalLinkParams

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

Path parameters

FieldTypePresence
card_idintegerRequired

Query parameters

none.

Request body

FieldTypePresence
urlstringRequired
descriptionstring | nullOptional

Response: Object. Fields: url, updated, created, id, description.

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

Remove external link. Kaiten documentation.

...args: CardExternalLinksRemoveExternalLinkParams

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

Path parameters

FieldTypePresence
card_idintegerRequired
idintegerRequired

Query parameters

none.

Response: Object. Fields: id.

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

Retrieve card external links. Kaiten documentation.

...args: CardExternalLinksRetrieveCardExternalLinksParams

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

Path parameters

FieldTypePresence
card_idintegerRequired

Query parameters

none.

Response: Array. Fields: 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 documentation.

...args: CardExternalLinksUpdateExternalLinkParams

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

Path parameters

FieldTypePresence
card_idintegerRequired
idintegerRequired

Query parameters

none.

Request body

FieldTypePresence
urlstringOptional
descriptionstring | nullOptional

Response: Object. Fields: url, updated, created, id, description.

cardFiles ​

attachFileToCard ​

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

Attach file to card Deprecated. Kaiten documentation. Deprecated operation.

...args: CardFilesAttachFileToCardParams

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

Path parameters

FieldTypePresence
card_idintegerRequired

Query parameters

none.

Request body

FieldTypePresence
filebinaryRequired

Response: Object. Fields: 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 documentation.

...args: CardFilesDetachFileFromCardParams

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

Path parameters

FieldTypePresence
card_idintegerRequired
idintegerRequired

Query parameters

none.

Response: Object. Fields: id.

updateFile ​

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

Update file. Kaiten documentation.

...args: CardFilesUpdateFileParams

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

Path parameters

FieldTypePresence
card_idintegerRequired
idintegerRequired

Query parameters

none.

Request body

FieldTypePresence
card_coverbooleanOptional

Response: Object

cardMembers ​

addMemberToCard ​

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

Add member to card. Kaiten documentation.

...args: CardMembersAddMemberToCardParams

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

Path parameters

FieldTypePresence
card_idintegerRequired

Query parameters

none.

Request body

FieldTypePresence
user_idintegerRequired

Response: Object. Fields: 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 documentation.

...args: CardMembersRemoveMemberFromCardParams

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

Path parameters

FieldTypePresence
card_idintegerRequired
idintegerRequired

Query parameters

none.

Response: Object. Fields: id.

retrieveListOfCardMembers ​

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

Retrieve list of card members. Kaiten documentation.

...args: CardMembersRetrieveListOfCardMembersParams

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

Path parameters

FieldTypePresence
card_idintegerRequired

Query parameters

none.

Response: Array. Fields: 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 documentation.

...args: CardMembersUpdateMemberRoleParams

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

Path parameters

FieldTypePresence
card_idintegerRequired
idintegerRequired

Query parameters

none.

Request body

FieldTypePresence
typeintegerRequired

Response: Object. Fields: 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 documentation.

...args: CardServiceDeskExternalRecipientsAddNewRecipientParams

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

Path parameters

FieldTypePresence
card_idintegerRequired

Query parameters

none.

Request body

FieldTypePresence
emailstringRequired

Response: Object. Fields: 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 documentation.

...args: CardServiceDeskExternalRecipientsRemoveRecipientParams

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

Path parameters

FieldTypePresence
card_idintegerRequired
emailstringRequired

Query parameters

none.

Response: Object. Fields: 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 documentation.

...args: CardSlaRetrieveCardSlaMeasurementsParams

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

Path parameters

FieldTypePresence
card_idintegerRequired

Query parameters

none.

Response: Object. Fields: calendars, rulesTimeData.

cardTags ​

addTag ​

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

Add tag. Kaiten documentation.

...args: CardTagsAddTagParams

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

Path parameters

FieldTypePresence
card_idintegerRequired

Query parameters

none.

Request body

FieldTypePresence
namestringRequired

Response: Object. Fields: 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 documentation.

...args: CardTagsRemoveTagFromCardParams

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

Path parameters

FieldTypePresence
card_idintegerRequired
tag_idintegerRequired

Query parameters

none.

Response: Object. Fields: id.

rertrieveListOfTags ​

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

Rertrieve list of tags. Kaiten documentation.

...args: CardTagsRertrieveListOfTagsParams

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

Path parameters

FieldTypePresence
card_idintegerRequired

Query parameters

none.

Response: Array. Fields: id, name, color, card_id, tag_id.

cardTimeLogs ​

addTimeLog ​

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

Add time log. Kaiten documentation.

...args: CardTimeLogsAddTimeLogParams

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

Path parameters

FieldTypePresence
card_idintegerRequired

Query parameters

none.

Request body

FieldTypePresence
role_idintegerRequired
time_spentintegerRequired
for_datestringRequired
commentstringOptional

Response: Object. Fields: 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 documentation.

...args: CardTimeLogsGetTimeLogsParams

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

Path parameters

FieldTypePresence
card_idintegerRequired

Query parameters

FieldTypePresence
for_datestringOptional
personalbooleanOptional

Response: Array. Fields: 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 documentation.

...args: CardTimeLogsRemoveTimeLogParams

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

Path parameters

FieldTypePresence
card_idintegerRequired
idintegerRequired

Query parameters

none.

Response: Object. Fields: id.

updateLogRecord ​

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

Update log record. Kaiten documentation.

...args: CardTimeLogsUpdateLogRecordParams

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

Path parameters

FieldTypePresence
card_idintegerRequired
idintegerRequired

Query parameters

none.

Request body

FieldTypePresence
role_idintegerOptional
time_spentintegerOptional
for_datestringOptional
commentstringOptional

Response: Object. Fields: 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 documentation.

...args: CardTypeTreeEntitiesAddTreeEntityToCardTypeParams

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

Path parameters

FieldTypePresence
type_idintegerRequired

Query parameters

none.

Request body

FieldTypePresence
tree_entity_uidstringRequired

Response: Object. Fields: id.

deleteTreeEntityFromCardType ​

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

Delete tree entity from card type. Kaiten documentation.

...args: CardTypeTreeEntitiesDeleteTreeEntityFromCardTypeParams

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

Path parameters

FieldTypePresence
type_idintegerRequired
uidstringRequired

Query parameters

none.

Response: No body

getListOfTypeTreeEntities ​

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

Get list of type tree entities. Kaiten documentation.

...args: CardTypeTreeEntitiesGetListOfTypeTreeEntitiesParams

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

Path parameters

FieldTypePresence
type_idintegerRequired

Query parameters

none.

Response: Array. Fields: 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 documentation.

...args: CardTypesCreateNewCardTypeParams

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

Path parameters

none.

Query parameters

none.

Request body

FieldTypePresence
letterstringRequired
namestringRequired
colorintegerRequired
propertiesobjectOptional
card_propertiesarray of unknown | unknownOptional
suggest_fieldsbooleanOptional

Response: Object. Fields: 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 documentation.

...args: CardTypesGetCardTypeParams

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

Path parameters

FieldTypePresence
idintegerRequired

Query parameters

none.

Response: Object. Fields: 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 documentation.

...args: CardTypesGetListOfCardTypesParams

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

Path parameters

none.

Query parameters

FieldTypePresence
limitintegerOptional
offsetintegerOptional

Response: Array. Fields: 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 documentation.

...args: CardTypesRemoveCardTypeParams

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

Path parameters

FieldTypePresence
idintegerRequired

Query parameters

none.

Request body

FieldTypePresence
replace_type_idnumberRequired

Response: Object. Fields: 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 documentation.

...args: CardTypesUpdateCardTypeParams

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

Path parameters

FieldTypePresence
idintegerRequired

Query parameters

none.

Request body

FieldTypePresence
letterstringOptional
namestringOptional
colorintegerOptional
propertiesobjectOptional
card_propertiesarray of unknown | unknownOptional
suggest_fieldsbooleanOptional

Response: Object. Fields: 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 documentation.

...args: CardsBatchUpdateForCardsParams

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

Path parameters

none.

Query parameters

none.

Request body

FieldTypePresence
board_idintegerOptional
column_idintegerOptional
lane_idintegerOptional
owner_idintegerOptional
type_idintegerOptional
condition1 | 2Optional
attributesunknown | unknown | unknown | unknown | unknown | unknownOptional
order_byunknownOptional

Response: Object. Fields: id.

createNewCard ​

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

Create new card. Kaiten documentation.

...args: CardsCreateNewCardParams

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

Path parameters

none.

Query parameters

none.

Request body

FieldTypePresence
titlenumber | stringRequired
board_idintegerRequired
asapbooleanOptional
due_datestring | nullOptional
due_date_time_presentbooleanOptional
sort_ordernumberOptional
descriptionnumber | string | nullOptional
expires_laterbooleanOptional
size_textnumber | string | nullOptional
column_idintegerOptional
lane_idintegerOptional
owner_idintegerOptional
responsible_idintegerOptional
owner_emailstringOptional
position1 | 2Optional
type_idintegerOptional
service_idinteger | nullOptional
external_idnumber | string | nullOptional
text_format_type_id1 | 2 | 3Optional
propertiesobjectOptional

Response: Object. Fields: 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 documentation.

...args: CardsDeleteCardParams

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

Path parameters

FieldTypePresence
card_idintegerRequired

Query parameters

none.

Response: Object. Fields: 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 documentation.

...args: CardsRetrieveCardParams

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

Path parameters

FieldTypePresence
card_idintegerRequired

Query parameters

FieldTypePresence
broken_apibooleanOptional

Response: Object. Fields: 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 documentation.

...args: CardsRetrieveCardBaselinesParams

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

Path parameters

FieldTypePresence
card_idintegerRequired

Query parameters

none.

Response: Array. Fields: id, uid, baseline_id, planned_start, planned_end.

retrieveCardList ​

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

Comma-separated query fields accept QueryList<T>: a string or a readonly array of the field's value type. See typed card filters for examples.

Retrieve card list. Kaiten documentation.

...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>
  >;
};

With query.version: 2, the result is SearchResponseV2<...> containing result and position; otherwise the result is an array.

Path parameters

none.

Query parameters

FieldTypePresence
created_beforestringOptional
created_afterstringOptional
updated_beforestringOptional
updated_afterstringOptional
first_moved_in_progress_afterstringOptional
first_moved_in_progress_beforestringOptional
last_moved_to_done_at_afterstringOptional
last_moved_to_done_at_beforestringOptional
due_date_afterstringOptional
due_date_beforestringOptional
querystringOptional
versionintegerOptional
tagstringOptional
tag_idsstringOptional
type_idsstringOptional
exclude_board_idsstringOptional
exclude_lane_idsstringOptional
exclude_column_idsstringOptional
column_idsstringOptional
member_idsstringOptional
owner_idsstringOptional
responsible_idsstringOptional
statesstringOptional
external_idstringOptional
additional_card_fieldsstringOptional
search_fieldsstringOptional
space_idintegerOptional
limitintegerOptional
offsetintegerOptional
start_positionstringOptional
include_search_previewbooleanOptional
order_space_idintegerOptional
board_idintegerOptional
column_idintegerOptional
lane_idintegerOptional
conditionintegerOptional
type_idintegerOptional
responsible_idintegerOptional
owner_idintegerOptional
archivedbooleanOptional
asapbooleanOptional
overduebooleanOptional
done_on_timebooleanOptional
with_due_datebooleanOptional
filterstring / CardFilterOptional
order_bystringOptional
order_directionstringOptional
is_requestbooleanOptional
exclude_owner_idsstringOptional
exclude_card_idsstringOptional
organizations_idsstringOptional
broken_apibooleanOptional

Response: Array. Fields: 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 documentation.

...args: CardsRetrieveCardLocationHistoryParams

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

Path parameters

FieldTypePresence
card_idintegerRequired

Query parameters

none.

Response: Array. Fields: 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 documentation.

...args: CardsUpdateCardParams

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

Path parameters

FieldTypePresence
card_idintegerRequired

Query parameters

none.

Request body

FieldTypePresence
titlenumber | stringOptional
asapbooleanOptional
due_datestring | nullOptional
due_date_time_presentbooleanOptional
sort_ordernumberOptional
descriptionnumber | string | nullOptional
expires_laterbooleanOptional
size_textnumber | string | nullOptional
board_idintegerOptional
column_idintegerOptional
lane_idintegerOptional
owner_idintegerOptional
type_idintegerOptional
service_idinteger | nullOptional
blockedbooleanOptional
condition1 | 2Optional
external_idnumber | string | nullOptional
text_format_type_id1 | 2 | 3Optional
sd_new_commentbooleanOptional
owner_emailstringOptional
prev_card_idintegerOptional
estimate_workloadnumberOptional
ignore_planned_dates_recalculationbooleanOptional
propertiesobjectOptional

Response: Object. Fields: 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 documentation.

...args: ChecklistItemsAddItemToChecklistParams

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

Path parameters

FieldTypePresence
checklist_idintegerRequired

Query parameters

none.

Request body

FieldTypePresence
textstringRequired
sort_ordernumberOptional
checkedbooleanOptional
due_datestring | nullOptional
responsible_idintegerOptional

Response: Object. Fields: 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 documentation.

...args: ChecklistItemsRemoveChecklistItemParams

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

Path parameters

FieldTypePresence
checklist_idintegerRequired
idintegerRequired

Query parameters

none.

Response: Object. Fields: id.

updateChecklistItem ​

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

Update checklist item. Kaiten documentation.

...args: ChecklistItemsUpdateChecklistItemParams

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

Path parameters

FieldTypePresence
checklist_idintegerRequired
idintegerRequired

Query parameters

none.

Request body

FieldTypePresence
textstring | nullOptional
sort_ordernumberOptional
checklist_idintegerOptional
checkedbooleanOptional
due_datestring | nullOptional
responsible_idnumber | nullOptional

Response: Object. Fields: 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 documentation.

...args: ChecklistsRetrieveCardsWithChecklistParams

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

Path parameters

FieldTypePresence
idintegerRequired

Query parameters

FieldTypePresence
only_shared_cardsbooleanRequired

Response: Array. Fields: 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 documentation.

...args: ColumnsCreateNewColumnParams

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

Path parameters

FieldTypePresence
board_idintegerRequired

Query parameters

none.

Request body

FieldTypePresence
external_idnumber | string | nullOptional
titlestringRequired
sort_ordernumberOptional
type1 | 2 | 3Optional
last_moved_warning_after_daysintegerOptional
last_moved_warning_after_hoursintegerOptional
last_moved_warning_after_minutesintegerOptional
wip_limitintegerOptional
wip_limit_type1 | 2Optional
col_countintegerOptional
archive_after_daysintegerOptional
months_to_hide_cardsinteger | nullOptional
card_hide_after_daysinteger | nullOptional
rulesintegerOptional

Response: Object. Fields: 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 documentation.

...args: ColumnsGetListOfColumnsParams

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

Path parameters

FieldTypePresence
board_idintegerRequired

Query parameters

none.

Response: Array. Fields: 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 documentation.

...args: ColumnsRemoveColumnParams

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

Path parameters

FieldTypePresence
board_idintegerRequired
idintegerRequired

Query parameters

none.

Request body

FieldTypePresence
forcebooleanOptional

Response: Object. Fields: id.

updateColumn ​

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

Update column. Kaiten documentation.

...args: ColumnsUpdateColumnParams

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

Path parameters

FieldTypePresence
board_idintegerRequired
idintegerRequired

Query parameters

none.

Request body

FieldTypePresence
external_idnumber | string | nullOptional
titlestringOptional
sort_ordernumberOptional
type1 | 2 | 3Optional
wip_limitinteger | nullOptional
wip_limit_type1 | 2Optional
last_moved_warning_after_daysintegerOptional
last_moved_warning_after_hoursintegerOptional
last_moved_warning_after_minutesintegerOptional
col_countintegerOptional
archive_after_daysintegerOptional
months_to_hide_cardsinteger | nullOptional
card_hide_after_daysinteger | nullOptional
rulesintegerOptional
default_tagsstring | nullOptional
prev_column_idinteger | nullOptional
next_column_idinteger | nullOptional
pause_slabooleanOptional

Response: Object. Fields: 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 documentation.

...args: CompanyUsersGetListOfUsersParams

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

Path parameters

none.

Query parameters

FieldTypePresence
invitesOnlybooleanOptional
withTransferAccessStatusbooleanOptional
for_members_sectionbooleanOptional
owner_onlybooleanOptional
only_paidbooleanOptional
only_records_countbooleanOptional
only_virtualbooleanOptional
offsetintegerOptional
limitintegerOptional
querystringOptional
access_type_permissionsstringOptional
sd_access_typestringOptional
take_licencestringOptional
temporarily_inactive_statusstringOptional
group_idsarrayOptional
permissionsarrayOptional

Response: Array. Fields: 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 documentation.

...args: CompanyUsersRemoveVirtualUserParams

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

Path parameters

FieldTypePresence
idintegerRequired

Query parameters

none.

Response: Object. Fields: id.

updateUser ​

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

Update user. Kaiten documentation.

...args: CompanyUsersUpdateUserParams

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

Path parameters

FieldTypePresence
idintegerRequired

Query parameters

none.

Request body

FieldTypePresence
apps_permissionsintegerOptional
temporarily_inactivebooleanOptional

Response: Object. Fields: 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 documentation. Beta.

...args: CustomDirectoriesCreateCustomDirectoryParams

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

Path parameters

none.

Query parameters

none.

Request body

FieldTypePresence
namestringRequired
descriptionnull | stringOptional
multi_selectbooleanOptional
allow_editingbooleanOptional
display_field_indexintegerOptional
fieldsarray of objectOptional

Response: Object. Fields: 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 documentation. Beta.

...args: CustomDirectoriesDeleteCustomDirectoryParams

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

Path parameters

FieldTypePresence
directory_idstringRequired

Query parameters

none.

Response: Object. Fields: id, name, condition, updated.

getCustomDirectory ​

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

Get custom directory. Kaiten documentation. Beta.

...args: CustomDirectoriesGetCustomDirectoryParams

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

Path parameters

FieldTypePresence
directory_idstringRequired

Query parameters

none.

Response: Object. Fields: 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 documentation. Beta.

...args: CustomDirectoriesGetListOfCustomDirectoriesParams

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

Path parameters

none.

Query parameters

FieldTypePresence
include_fieldsbooleanOptional
include_authorbooleanOptional
include_records_countbooleanOptional
limitnumberOptional
offsetnumberOptional
querystringOptional
conditionsarray of stringsOptional

Response: Array. Fields: 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 documentation. Beta.

...args: CustomDirectoriesUpdateCustomDirectoryParams

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

Path parameters

FieldTypePresence
directory_idstringRequired

Query parameters

none.

Request body

FieldTypePresence
namestringOptional
descriptionnull | stringOptional
conditionactive | inactive | removedOptional
multi_selectbooleanOptional
allow_editingbooleanOptional
fieldsarray of objectOptional

Response: Object. Fields: 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 documentation. Beta.

...args: CustomDirectoryFieldsCreateFieldParams

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

Path parameters

FieldTypePresence
directory_idstringRequired

Query parameters

none.

Request body

FieldTypePresence
namestringRequired
typestring | number | date | email | url | phone | checkbox | select | user | catalog | directory_link | fileRequired
sort_orderintegerOptional
requiredbooleanOptional
is_displaybooleanOptional

Response: Object. Fields: 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 documentation. Beta.

...args: CustomDirectoryFieldsDeleteFieldParams

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

Path parameters

FieldTypePresence
directory_idstringRequired
field_idstringRequired

Query parameters

none.

Response: Object. Fields: 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 documentation. Beta.

...args: CustomDirectoryFieldsGetFieldParams

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

Path parameters

FieldTypePresence
directory_idstringRequired
field_idstringRequired

Query parameters

none.

Response: Object. Fields: 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 documentation. Beta.

...args: CustomDirectoryFieldsGetListOfFieldsParams

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

Path parameters

FieldTypePresence
directory_idstringRequired

Query parameters

FieldTypePresence
include_authorbooleanOptional
conditionsarray of stringsOptional

Response: Array. Fields: 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 documentation. Beta.

...args: CustomDirectoryFieldsUpdateFieldParams

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

Path parameters

FieldTypePresence
directory_idstringRequired
field_idstringRequired

Query parameters

none.

Request body

FieldTypePresence
namestringOptional
conditionactive | inactive | removedOptional
sort_orderintegerOptional
requiredbooleanOptional
is_displaybooleanOptional

Response: Object. Fields: 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 documentation. Beta.

...args: CustomDirectoryRecordsCreateRecordParams

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

Path parameters

FieldTypePresence
directory_idstringRequired

Query parameters

FieldTypePresence
response_profilestringOptional

Request body

FieldTypePresence
valuesobjectRequired

Response: Object. Fields: 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 documentation. Beta.

...args: CustomDirectoryRecordsDeleteRecordParams

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

Path parameters

FieldTypePresence
directory_idstringRequired
record_idstringRequired

Query parameters

none.

Response: Object. Fields: 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 documentation. Beta.

...args: CustomDirectoryRecordsGetCardsLinkedToRecordParams

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

Path parameters

FieldTypePresence
directory_idstringRequired
record_idstringRequired

Query parameters

FieldTypePresence
limitnumberOptional
offsetnumberOptional
filterstringOptional

Response: Array. Fields: id, uid, title.

getListOfRecords ​

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

Get list of records. Kaiten documentation. Beta.

...args: CustomDirectoryRecordsGetListOfRecordsParams

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

Path parameters

FieldTypePresence
directory_idstringRequired

Query parameters

FieldTypePresence
limitnumberOptional
offsetnumberOptional
querystringOptional
profilestringOptional
include_valuesbooleanOptional
include_authorbooleanOptional
conditionsarray of stringsOptional
filtersobjectOptional
filter_operatorstringOptional

Response: Array. Fields: 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 documentation. Beta.

...args: CustomDirectoryRecordsGetRecordParams

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

Path parameters

FieldTypePresence
directory_idstringRequired
record_idstringRequired

Query parameters

FieldTypePresence
profilestringOptional

Response: Object. Fields: 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 documentation. Beta.

...args: CustomDirectoryRecordsUpdateRecordParams

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

Path parameters

FieldTypePresence
directory_idstringRequired
record_idstringRequired

Query parameters

FieldTypePresence
response_profilestringOptional

Request body

FieldTypePresence
conditionactive | inactive | removedOptional
valuesobjectOptional

Response: Object. Fields: 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 documentation.

...args: CustomPropertiesCreateNewPropertyParams

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

Path parameters

none.

Query parameters

none.

Request body

FieldTypePresence
namestringOptional
show_on_facadebooleanOptional
multilinebooleanOptional
vote_variantnull | rating | scale | emoji_setOptional
typestring | number | date | email | phone | checkbox | select | formula | url | collective_score | vote | collective_vote | catalog | user | attachmentOptional
values_typenull | number | textOptional
colorfulboolean | nullOptional
multi_selectboolean | nullOptional
values_creatable_by_usersboolean | nullOptional
dataunknown | unknown | unknown | unknown | unknownOptional
formulastringOptional
formula_source_cardobjectOptional
colorinteger | nullOptional
fields_settingsobjectOptional

Response: Object. Fields: 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 documentation.

...args: CustomPropertiesGetListOfPropertiesParams

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

Path parameters

none.

Query parameters

FieldTypePresence
include_valuesbooleanOptional
include_authorbooleanOptional
compactbooleanOptional
load_by_idsbooleanOptional
idsarrayOptional
offsetintegerOptional
limitintegerOptional
order_bystringOptional
order_directionstringOptional
querystringOptional

Response: Array. Fields: 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 documentation.

...args: CustomPropertiesGetPropertyParams

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

Path parameters

FieldTypePresence
idintegerRequired

Query parameters

none.

Response: Object. Fields: 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 documentation.

...args: CustomPropertiesRemovePropertyParams

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

Path parameters

FieldTypePresence
idintegerRequired

Query parameters

none.

Response: Object. Fields: 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 documentation.

...args: CustomPropertiesUpdatePropertyParams

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

Path parameters

FieldTypePresence
idintegerRequired

Query parameters

none.

Request body

FieldTypePresence
namestringOptional
show_on_facadebooleanOptional
multilinebooleanOptional
conditionactive | inactiveOptional
colorfulboolean | nullOptional
multi_selectboolean | nullOptional
values_creatable_by_usersboolean | nullOptional
dataunknown | unknown | unknown | unknown | unknownOptional
colorinteger | nullOptional
fields_settingsobject | nullOptional
is_used_as_progressbooleanOptional

Response: Object. Fields: 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 documentation.

...args: CustomPropertyCatalogValuesCreateNewCatalogValueParams

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

Path parameters

FieldTypePresence
property_idintegerRequired

Query parameters

none.

Request body

FieldTypePresence
valueobjectRequired

Response: Object. Fields: 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 documentation.

...args: CustomPropertyCatalogValuesGetCatalogValueParams

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

Path parameters

FieldTypePresence
property_idintegerRequired
idintegerRequired

Query parameters

none.

Response: Object. Fields: 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 documentation.

...args: CustomPropertyCatalogValuesGetListOfCatalogValuesParams

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

Path parameters

FieldTypePresence
property_idintegerRequired

Query parameters

FieldTypePresence
querystringOptional
conditionsenumOptional
limitintegerOptional
offsetintegerOptional

Response: Array. Fields: 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 documentation.

...args: CustomPropertyCatalogValuesRemovePropertyParams

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

Path parameters

FieldTypePresence
property_idintegerRequired
idintegerRequired

Query parameters

none.

Response: Object. Fields: 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 documentation.

...args: CustomPropertyCatalogValuesUpdateCatalogValueParams

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

Path parameters

FieldTypePresence
property_idintegerRequired
idintegerRequired

Query parameters

none.

Request body

FieldTypePresence
conditionactive | inactiveOptional
valueobjectOptional
deletedbooleanOptional

Response: Object. Fields: 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 documentation.

...args: CustomPropertyCollectiveScoreValuesCreateNewScoreValueParams

ts
declare const createNewScoreValue: (
  cardId: number,
  propertyId: number,
  value: string,
  options?: OperationOptions,
) => Promise<CustomPropertyCollectiveScoreValuesCreateNewScoreValueResponse>;

Path parameters

FieldTypePresence
card_idintegerRequired
property_idintegerRequired

Query parameters

none.

Request body

FieldTypePresence
valuestringRequired

Response: Object. Fields: 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 documentation.

...args: CustomPropertyCollectiveScoreValuesGetListOfScoreValuesParams

ts
declare const getListOfScoreValues: (
  cardId: number,
  propertyId: number,
  options?: OperationOptions,
) => Promise<CustomPropertyCollectiveScoreValuesGetListOfScoreValuesResponse>;

Path parameters

FieldTypePresence
card_idintegerRequired
property_idintegerRequired

Query parameters

none.

Response: Array. Fields: 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 documentation.

...args: CustomPropertyCollectiveScoreValuesUpdateScoreValueParams

ts
declare const updateScoreValue: (
  cardId: number,
  propertyId: number,
  valueId: number,
  value: string | null,
  options?: OperationOptions,
) => Promise<CustomPropertyCollectiveScoreValuesUpdateScoreValueResponse>;

Path parameters

FieldTypePresence
card_idintegerRequired
property_idintegerRequired
idintegerRequired

Query parameters

none.

Request body

FieldTypePresence
valuestring | nullOptional

Response: Object. Fields: 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 documentation.

...args: CustomPropertyCollectiveVoteValuesCreateNewVoteValueParams

ts
declare const createNewVoteValue: (
  cardId: number,
  propertyId: number,
  body: CustomPropertyCollectiveVoteValuesCreateNewVoteValueBody,
  options?: OperationOptions,
) => Promise<CustomPropertyCollectiveVoteValuesCreateNewVoteValueResponse>;

Path parameters

FieldTypePresence
card_idintegerRequired
property_idintegerRequired

Query parameters

none.

Request body

FieldTypePresence
emoji_votestringOptional
number_voteintegerOptional

Response: Object. Fields: 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 documentation.

...args: CustomPropertyCollectiveVoteValuesGetListOfVoteValuesParams

ts
declare const getListOfVoteValues: (
  cardId: number,
  propertyId: number,
  options?: OperationOptions,
) => Promise<CustomPropertyCollectiveVoteValuesGetListOfVoteValuesResponse>;

Path parameters

FieldTypePresence
card_idintegerRequired
property_idintegerRequired

Query parameters

none.

Response: Array. Fields: 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 documentation.

...args: CustomPropertyCollectiveVoteValuesRemoveVoteValueParams

ts
declare const removeVoteValue: (
  cardId: number,
  propertyId: number,
  id: number,
  emojiVote: string,
  options?: OperationOptions,
) => Promise<CustomPropertyCollectiveVoteValuesRemoveVoteValueResponse>;

Path parameters

FieldTypePresence
card_idintegerRequired
property_idintegerRequired
idintegerRequired

Query parameters

none.

Request body

FieldTypePresence
emoji_votestringOptional

Response: Object. Fields: 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 documentation.

...args: CustomPropertyCollectiveVoteValuesUpdateVoteValueParams

ts
declare const updateVoteValue: (
  cardId: number,
  propertyId: number,
  id: number,
  numberVote?: number | null,
  options?: OperationOptions,
) => Promise<CustomPropertyCollectiveVoteValuesUpdateVoteValueResponse>;

Path parameters

FieldTypePresence
card_idintegerRequired
property_idintegerRequired
idintegerRequired

Query parameters

none.

Request body

FieldTypePresence
number_votenumber | nullOptional

Response: Object. Fields: 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 documentation.

...args: CustomPropertySelectValuesCreateNewSelectValueParams

ts
declare const createNewSelectValue: (
  propertyId: number,
  value: string,
  color?: number | null,
  options?: OperationOptions,
) => Promise<CustomPropertySelectValuesCreateNewSelectValueResponse>;

Path parameters

FieldTypePresence
property_idintegerRequired

Query parameters

none.

Request body

FieldTypePresence
valuestringRequired
colorinteger | nullOptional

Response: Object. Fields: 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 documentation.

...args: CustomPropertySelectValuesGetListOfSelectValuesParams

ts
declare const getListOfSelectValues: (
  propertyId: number,
  query?: CustomPropertySelectValuesGetListOfSelectValuesQuery,
  options?: OperationOptions,
) => Promise<CustomPropertySelectValuesGetListOfSelectValuesResponse>;

Path parameters

FieldTypePresence
property_idintegerRequired

Query parameters

FieldTypePresence
v2_select_searchbooleanOptional
querystringOptional
order_bystringOptional
idsarrayOptional
conditionsarrayOptional
offsetintegerOptional
limitintegerOptional

Response: Array. Fields: 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 documentation.

...args: CustomPropertySelectValuesGetSelectValueParams

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

Path parameters

FieldTypePresence
property_idintegerRequired
idintegerRequired

Query parameters

none.

Response: Object. Fields: 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 documentation.

...args: CustomPropertySelectValuesRemovePropertyParams

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

Path parameters

FieldTypePresence
property_idintegerRequired
idintegerRequired

Query parameters

none.

Response: Object. Fields: 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 documentation.

...args: CustomPropertySelectValuesUpdateSelectValueParams

ts
declare const updateSelectValue: (
  propertyId: number,
  valueId: number,
  body: CustomPropertySelectValuesUpdateSelectValueBody,
  options?: OperationOptions,
) => Promise<CustomPropertySelectValuesUpdateSelectValueResponse>;

Path parameters

FieldTypePresence
property_idintegerRequired
idintegerRequired

Query parameters

none.

Request body

FieldTypePresence
valuestringOptional
colorinteger | nullOptional
conditionactive | inactiveOptional
sort_ordernumberOptional
deletedbooleanOptional

Response: Object. Fields: 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 documentation.

...args: CustomPropertyTreeEntitiesAddTreeEntityToCustomPropertyParams

ts
declare const addTreeEntityToCustomProperty: (
  propertyId: number,
  treeEntityUid: string,
  options?: OperationOptions,
) => Promise<CustomPropertyTreeEntitiesAddTreeEntityToCustomPropertyResponse>;

Path parameters

FieldTypePresence
property_idintegerRequired

Query parameters

none.

Request body

FieldTypePresence
tree_entity_uidstringRequired

Response: Object. Fields: id.

deleteTreeEntityFromCustomProperty ​

client.customPropertyTreeEntities.deleteTreeEntityFromCustomProperty · DELETE /api/latest/company/custom-properties/{property_id}/tree-entities/{uid}

Delete tree entity from custom property. Kaiten documentation.

...args: CustomPropertyTreeEntitiesDeleteTreeEntityFromCustomPropertyParams

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

Path parameters

FieldTypePresence
property_idintegerRequired
uidstringRequired

Query parameters

none.

Response: No body

getListOfCustomPropertyTreeEntities ​

client.customPropertyTreeEntities.getListOfCustomPropertyTreeEntities · GET /api/latest/company/custom-properties/{property_id}/tree-entities

Get list of custom property tree entities. Kaiten documentation.

...args: CustomPropertyTreeEntitiesGetListOfCustomPropertyTreeEntitiesParams

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

Path parameters

FieldTypePresence
property_idintegerRequired

Query parameters

none.

Response: Array. Fields: 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 documentation.

...args: DocumentGroupsCreateNewDocumentGroupParams

ts
declare const createNewDocumentGroup: (
  body: DocumentGroupsCreateNewDocumentGroupBody,
  options?: OperationOptions,
) => Promise<DocumentGroupsCreateNewDocumentGroupResponse>;

Path parameters

none.

Query parameters

none.

Request body

FieldTypePresence
titlestringRequired
parent_entity_uidstring | nullOptional
for_everyone_access_role_idstring | nullOptional
sort_ordernumberOptional
keystring | nullOptional

Response: Object. Fields: 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 documentation.

...args: DocumentGroupsRemoveDocumentGroupParams

ts
declare const removeDocumentGroup: (
  documentGroupUid: string,
  options?: OperationOptions,
) => Promise<DocumentGroupsRemoveDocumentGroupResponse>;

Path parameters

FieldTypePresence
document_group_uidstringRequired

Query parameters

none.

Response: Object. Fields: 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 documentation.

...args: DocumentGroupsRetrieveDocumentGroupParams

ts
declare const retrieveDocumentGroup: (
  documentGroupUid: string,
  options?: OperationOptions,
) => Promise<DocumentGroupsRetrieveDocumentGroupResponse>;

Path parameters

FieldTypePresence
document_group_uidstringRequired

Query parameters

none.

Response: Object. Fields: 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 documentation.

...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>
  >;
};

With query.version: 2, the result is SearchResponseV2<...> containing result and position; otherwise the result is an array.

Path parameters

none.

Query parameters

FieldTypePresence
querystringOptional
offsetintegerOptional
limitintegerOptional
versionintegerOptional
conditionintegerOptional
start_positionstringOptional
roleintegerOptional

Response: Array. Fields: 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 documentation.

...args: DocumentGroupsUpdateDocumentGroupParams

ts
declare const updateDocumentGroup: (
  documentGroupUid: string,
  body: DocumentGroupsUpdateDocumentGroupBody,
  options?: OperationOptions,
) => Promise<DocumentGroupsUpdateDocumentGroupResponse>;

Path parameters

FieldTypePresence
document_group_uidstringRequired

Query parameters

none.

Request body

FieldTypePresence
titlestringOptional
parent_entity_uidstring | nullOptional
sort_ordernumberOptional
accessfor_everyone | by_inviteOptional
for_everyone_access_role_idstring | nullOptional
hostnamestring | nullOptional
redirect_urlstring | nullOptional
keystring | nullOptional
icon_typematerial_icon | nullOptional
icon_valuestring | nullOptional
icon_colorinteger | nullOptional
hidden_on_public_sitebooleanOptional
news_feedbooleanOptional
index_document_uidstring | nullOptional

Response: Object. Fields: 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 documentation.

...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>;
};

Path parameters

FieldTypePresence
idstringRequired

Query parameters

FieldTypePresence
formatdraft-06 | prosemirrorOptional

Response: Object. Fields: $schema, $id, title, description, allOf, version, definitions.

documents ​

createNewDocument ​

client.documents.createNewDocument · POST /api/latest/documents

Create new document. Kaiten documentation.

...args: DocumentsCreateNewDocumentParams

ts
declare const createNewDocument: (
  body: DocumentsCreateNewDocumentBody,
  options?: OperationOptions,
) => Promise<DocumentsCreateNewDocumentResponse>;

Path parameters

none.

Query parameters

none.

Request body

FieldTypePresence
titlestringOptional
sort_ordernumberRequired
parent_entity_uidstring | nullOptional
for_everyone_access_role_idstringOptional
clone_uidstringOptional
clone_versionnumberOptional
keystring | nullOptional

Response: Object. Fields: 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 documentation.

...args: DocumentsRemoveDocumentParams

ts
declare const removeDocument: (
  documentUid: string,
  options?: OperationOptions,
) => Promise<DocumentsRemoveDocumentResponse>;

Path parameters

FieldTypePresence
document_uidstringRequired

Query parameters

none.

Response: Object. Fields: 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 documentation.

...args: DocumentsRetrieveDocumentParams

ts
declare const retrieveDocument: (
  documentUid: string,
  options?: OperationOptions,
) => Promise<DocumentsRetrieveDocumentResponse>;

Path parameters

FieldTypePresence
document_uidstringRequired

Query parameters

none.

Response: Object. Fields: 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 documentation.

...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>
  >;
};

With query.version: 2, the result is SearchResponseV2<...> containing result and position; otherwise the result is an array.

Path parameters

none.

Query parameters

FieldTypePresence
querystringOptional
offsetintegerOptional
limitintegerOptional
versionintegerOptional
conditionintegerOptional
fieldsstringOptional
start_positionstringOptional
include_search_previewbooleanOptional

Response: Array. Fields: 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 documentation.

...args: DocumentsUpdateDocumentParams

ts
declare const updateDocument: (
  documentUid: string,
  body: DocumentsUpdateDocumentBody,
  options?: OperationOptions,
) => Promise<DocumentsUpdateDocumentResponse>;

Path parameters

FieldTypePresence
document_uidstringRequired

Query parameters

none.

Request body

FieldTypePresence
titlestringOptional
sort_ordernumberOptional
publish_datestring | nullOptional
dataobjectOptional
accessfor_everyone | by_inviteOptional
parent_entity_uidstring | nullOptional
for_everyone_access_role_idstringOptional
publicbooleanOptional
redirect_urlstring | nullOptional
hidden_on_public_sitebooleanOptional
settingsobjectOptional
backup_versionnumberOptional
published_versionnumber | null | currentOptional
keystring | nullOptional
icon_typeemoji | material_icon | nullOptional
icon_valuestring | nullOptional
icon_colorinteger | nullOptional
notification_period_startstring | nullOptional
notification_period_endstring | nullOptional
slugstring | nullOptional

Response: Object. Fields: 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 documentation. Beta.

...args: GroupAdminsAddAdminToGroupParams

ts
declare const addAdminToGroup: (
  groupUid: string,
  userId: number,
  options?: OperationOptions,
) => Promise<GroupAdminsAddAdminToGroupResponse>;

Path parameters

FieldTypePresence
group_uidstringRequired

Query parameters

none.

Request body

FieldTypePresence
user_idintegerRequired

Response: Object. Fields: 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 documentation. Beta.

...args: GroupAdminsGetListOfGroupAdminsParams

ts
declare const getListOfGroupAdmins: (
  groupUid: string,
  options?: OperationOptions,
) => Promise<GroupAdminsGetListOfGroupAdminsResponse>;

Path parameters

FieldTypePresence
group_uidstringRequired

Query parameters

none.

Response: Array. Fields: 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 documentation. Beta.

...args: GroupAdminsRemoveAdminFromGroupParams

ts
declare const removeAdminFromGroup: (
  groupUid: string,
  userId: number,
  options?: OperationOptions,
) => Promise<GroupAdminsRemoveAdminFromGroupResponse>;

Path parameters

FieldTypePresence
group_uidstringRequired
user_idintegerRequired

Query parameters

none.

Response: Object. Fields: 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 documentation. Beta.

...args: GroupEntitiesAddEntityParams

ts
declare const addEntity: (
  groupUid: string,
  entityUid: string,
  roleIds: string[],
  options?: OperationOptions,
) => Promise<GroupEntitiesAddEntityResponse>;

Path parameters

FieldTypePresence
group_uidstringRequired

Query parameters

none.

Request body

FieldTypePresence
entity_uidstringRequired
role_idsarray of stringRequired

Response: Object. Fields: 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 documentation. Beta.

...args: GroupEntitiesGetListOfGroupEntitiesParams

ts
declare const getListOfGroupEntities: (
  groupUid: string,
  options?: OperationOptions,
) => Promise<GroupEntitiesGetListOfGroupEntitiesResponse>;

Path parameters

FieldTypePresence
group_uidstringRequired

Query parameters

none.

Response: Array. Fields: uid, path, title, entity_type, own_role_ids.

removeEntity ​

client.groupEntities.removeEntity · DELETE /api/latest/company/groups/{group_uid}/entities/{uid}

Remove entity. Kaiten documentation. Beta.

...args: GroupEntitiesRemoveEntityParams

ts
declare const removeEntity: (
  groupUid: string,
  uid: string,
  options?: OperationOptions,
) => Promise<GroupEntitiesRemoveEntityResponse>;

Path parameters

FieldTypePresence
group_uidstringRequired
uidstringRequired

Query parameters

none.

Response: Object. Fields: 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 documentation. Beta.

...args: GroupEntitiesUpdateGroupEntityParams

ts
declare const updateGroupEntity: (
  groupUid: string,
  uid: string,
  roleIds: string[],
  options?: OperationOptions,
) => Promise<GroupEntitiesUpdateGroupEntityResponse>;

Path parameters

FieldTypePresence
group_uidstringRequired
uidstringRequired

Query parameters

none.

Request body

FieldTypePresence
role_idsarray of stringOptional

Response: Object. Fields: 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 documentation. Beta.

...args: GroupUsersAddUserToGroupParams

ts
declare const addUserToGroup: (
  groupUid: string,
  userId: number,
  requestId?: string,
  operatorComment?: string | null,
  options?: OperationOptions,
) => Promise<GroupUsersAddUserToGroupResponse>;

Path parameters

FieldTypePresence
group_uidstringRequired

Query parameters

none.

Request body

FieldTypePresence
user_idintegerRequired
request_idstringOptional
operator_commentstring | nullOptional

Response: Object. Fields: 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 documentation. Beta.

...args: GroupUsersGetListOfGroupUsersParams

ts
declare const getListOfGroupUsers: (
  groupUid: string,
  options?: OperationOptions,
) => Promise<GroupUsersGetListOfGroupUsersResponse>;

Path parameters

FieldTypePresence
group_uidstringRequired

Query parameters

none.

Response: Array. Fields: 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 documentation. Beta.

...args: GroupUsersRemoveUserFromGroupParams

ts
declare const removeUserFromGroup: (
  groupUid: string,
  userId: number,
  options?: OperationOptions,
) => Promise<GroupUsersRemoveUserFromGroupResponse>;

Path parameters

FieldTypePresence
group_uidstringRequired
user_idintegerRequired

Query parameters

none.

Response: Object. Fields: 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 documentation. Beta.

...args: GroupsCreateGroupParams

ts
declare const createGroup: (
  name: string,
  permissions?: number,
  addToCardsAndSpacesEnabled?: boolean,
  options?: OperationOptions,
) => Promise<GroupsCreateGroupResponse>;

Path parameters

none.

Query parameters

none.

Request body

FieldTypePresence
namestringRequired
permissionsintegerOptional
add_to_cards_and_spaces_enabledbooleanOptional

Response: Object. Fields: 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 documentation. Beta.

...args: GroupsGetGroupParams

ts
declare const getGroup: (
  uid: string,
  options?: OperationOptions,
) => Promise<GroupsGetGroupResponse>;

Path parameters

FieldTypePresence
uidstringRequired

Query parameters

none.

Response: Object. Fields: 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 documentation. Beta.

...args: GroupsGetListOfGroupsParams

ts
declare const getListOfGroups: (
  query?: GroupsGetListOfGroupsQuery,
  options?: OperationOptions,
) => Promise<GroupsGetListOfGroupsResponse>;

Path parameters

none.

Query parameters

FieldTypePresence
with_tree_entitiesbooleanOptional
with_users_countbooleanOptional
with_sync_group_attributebooleanOptional
conditionenumOptional
querystringOptional
limitintegerOptional
offsetintegerOptional

Response: Array. Fields: 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 documentation. Beta.

...args: GroupsRemoveGroupParams

ts
declare const removeGroup: (
  uid: string,
  options?: OperationOptions,
) => Promise<GroupsRemoveGroupResponse>;

Path parameters

FieldTypePresence
uidstringRequired

Query parameters

none.

Response: Object. Fields: 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 documentation. Beta.

...args: GroupsUpdateGroupParams

ts
declare const updateGroup: (
  uid: string,
  name?: string,
  permissions?: number,
  addToCardsAndSpacesEnabled?: boolean,
  options?: OperationOptions,
) => Promise<GroupsUpdateGroupResponse>;

Path parameters

FieldTypePresence
uidstringRequired

Query parameters

none.

Request body

FieldTypePresence
namestringOptional
permissionsintegerOptional
add_to_cards_and_spaces_enabledbooleanOptional

Response: Object. Fields: 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 documentation. Beta.

...args: IterationsAddCardToIterationParams

ts
declare const addCardToIteration: (
  spaceUid: string,
  iterationId: string,
  cardUid: string,
  options?: OperationOptions,
) => Promise<IterationsAddCardToIterationResponse>;

Path parameters

FieldTypePresence
space_uidstringRequired
iteration_idstringRequired

Query parameters

none.

Request body

FieldTypePresence
card_uidstringRequired

Response: Object. Fields: 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 documentation. Beta.

...args: IterationsCreateIterationParams

ts
declare const createIteration: (
  spaceUid: string,
  body: IterationsCreateIterationBody,
  options?: OperationOptions,
) => Promise<IterationsCreateIterationResponse>;

Path parameters

FieldTypePresence
space_uidstringRequired

Query parameters

none.

Request body

FieldTypePresence
titlestringRequired
goalstring | nullOptional
start_datestring | nullOptional
finish_datestring | nullOptional

Response: Object. Fields: 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 documentation. Beta.

...args: IterationsDeleteIterationParams

ts
declare const deleteIteration: (
  spaceUid: string,
  id: string,
  newIterationId?: string | null,
  options?: OperationOptions,
) => Promise<IterationsDeleteIterationResponse>;

Path parameters

FieldTypePresence
space_uidstringRequired
idstringRequired

Query parameters

none.

Request body

FieldTypePresence
new_iteration_idstring | nullOptional

Response: Object. Fields: 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 documentation. Beta.

...args: IterationsGetCardIterationsHistoryParams

ts
declare const getCardIterationsHistory: (
  cardUid: string,
  withDetails?: boolean,
  options?: OperationOptions,
) => Promise<IterationsGetCardIterationsHistoryResponse>;

Path parameters

FieldTypePresence
card_uidstringRequired

Query parameters

FieldTypePresence
with_detailsbooleanOptional

Response: Array. Fields: 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 documentation. Beta.

...args: IterationsGetIterationParams

ts
declare const getIteration: (
  spaceUid: string,
  id: string,
  options?: OperationOptions,
) => Promise<IterationsGetIterationResponse>;

Path parameters

FieldTypePresence
space_uidstringRequired
idstringRequired

Query parameters

none.

Response: Object. Fields: 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 documentation. Beta.

...args: IterationsRemoveCardFromIterationParams

ts
declare const removeCardFromIteration: (
  spaceUid: string,
  iterationId: string,
  uid: string,
  options?: OperationOptions,
) => Promise<IterationsRemoveCardFromIterationResponse>;

Path parameters

FieldTypePresence
space_uidstringRequired
iteration_idstringRequired
uidstringRequired

Query parameters

none.

Response: Object. Fields: 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 documentation. Beta.

...args: IterationsRetrieveCardsInIterationParams

ts
declare const retrieveCardsInIteration: (
  spaceUid: string,
  iterationId: string,
  status?: string,
  options?: OperationOptions,
) => Promise<IterationsRetrieveCardsInIterationResponse>;

Path parameters

FieldTypePresence
space_uidstringRequired
iteration_idstringRequired

Query parameters

FieldTypePresence
statusstringOptional

Response: Array. Fields: 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 documentation. Beta.

...args: IterationsRetrieveListOfIterationsParams

ts
declare const retrieveListOfIterations: (
  spaceUid: string,
  query?: IterationsRetrieveListOfIterationsQuery,
  options?: OperationOptions,
) => Promise<IterationsRetrieveListOfIterationsResponse>;

Path parameters

FieldTypePresence
space_uidstringRequired

Query parameters

FieldTypePresence
statusstringOptional
with_datastringOptional
limitnumberOptional
offsetnumberOptional
orderstringOptional

Response: Array. Fields: 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 documentation. Beta.

...args: IterationsUpdateIterationParams

ts
declare const updateIteration: (
  spaceUid: string,
  id: string,
  body: IterationsUpdateIterationBody,
  options?: OperationOptions,
) => Promise<IterationsUpdateIterationResponse>;

Path parameters

FieldTypePresence
space_uidstringRequired
idstringRequired

Query parameters

none.

Request body

FieldTypePresence
titlestringOptional
goalstring | nullOptional
statusplanned | active | closedOptional
start_datestring | nullOptional
finish_datestring | nullOptional
actual_finish_datestring | nullOptional
new_iteration_idstring | nullOptional

Response: Object. Fields: 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 documentation.

...args: LanesCreateNewLaneParams

ts
declare const createNewLane: (
  boardId: number,
  body: LanesCreateNewLaneBody,
  options?: OperationOptions,
) => Promise<LanesCreateNewLaneResponse>;

Path parameters

FieldTypePresence
board_idintegerRequired

Query parameters

none.

Request body

FieldTypePresence
titlestringRequired
sort_ordernumberOptional
wip_limitintegerOptional
wip_limit_type1 | 2Optional
last_moved_warning_after_daysintegerOptional
last_moved_warning_after_hoursintegerOptional
last_moved_warning_after_minutesintegerOptional
row_countintegerOptional

Response: Object. Fields: 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 documentation.

...args: LanesGetListOfLanesParams

ts
declare const getListOfLanes: (
  boardId: number,
  condition?: string,
  options?: OperationOptions,
) => Promise<LanesGetListOfLanesResponse>;

Path parameters

FieldTypePresence
board_idintegerRequired

Query parameters

FieldTypePresence
conditionenumOptional

Response: Array. Fields: 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 documentation.

...args: LanesRemoveLaneParams

ts
declare const removeLane: (
  boardId: number,
  laneId: number,
  force?: boolean,
  options?: OperationOptions,
) => Promise<LanesRemoveLaneResponse>;

Path parameters

FieldTypePresence
board_idintegerRequired
idintegerRequired

Query parameters

none.

Request body

FieldTypePresence
forcebooleanOptional

Response: Object. Fields: id.

updateLane ​

client.lanes.updateLane · PATCH /api/latest/boards/{board_id}/lanes/{id}

Update lane. Kaiten documentation.

...args: LanesUpdateLaneParams

ts
declare const updateLane: (
  boardId: number,
  laneId: number,
  body: LanesUpdateLaneBody,
  options?: OperationOptions,
) => Promise<LanesUpdateLaneResponse>;

Path parameters

FieldTypePresence
board_idintegerRequired
idintegerRequired

Query parameters

none.

Request body

FieldTypePresence
titlestringOptional
sort_ordernumberOptional
wip_limitinteger | nullOptional
wip_limit_type1 | 2Optional
last_moved_warning_after_daysintegerOptional
last_moved_warning_after_hoursintegerOptional
last_moved_warning_after_minutesintegerOptional
row_countintegerOptional
default_tagsstring | nullOptional
default_card_type_idinteger | nullOptional
condition1 | 2Optional

Response: Object. Fields: 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 documentation.

...args: RestrictedAccessCardFilesAttachFileToCardParams

ts
declare const attachFileToCard: (
  cardUid: string,
  file: Blob,
  options?: FileUploadOptions,
) => Promise<RestrictedAccessCardFilesAttachFileToCardResponse>;

Path parameters

FieldTypePresence
card_uidstring (uuid)Required

Query parameters

none.

Request body

FieldTypePresence
fileBlobRequired

Response: Object. Fields: 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 documentation.

...args: RestrictedAccessCardFilesDeleteCardFileParams

ts
declare const deleteCardFile: (
  cardUid: string,
  fileUid: string,
  options?: OperationOptions,
) => Promise<RestrictedAccessCardFilesDeleteCardFileResponse>;

Path parameters

FieldTypePresence
card_uidstring (uuid)Required
idstring (uuid)Required

Query parameters

none.

Response: Object. Fields: id.

getCardFile ​

client.restrictedAccessCardFiles.getCardFile · GET /api/latest/cards/{card_uid}/files/{id}

Get card file. Kaiten documentation.

...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
  >;
};

Path parameters

FieldTypePresence
card_uidstring (uuid)Required
idstring (uuid)Required

Query parameters

FieldTypePresence
redirectbooleanOptional
downloadbooleanOptional

Response: Object. Fields: 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 documentation.

...args: RestrictedAccessCardFilesUpdateCardFileParams

ts
declare const updateCardFile: (
  cardUid: string,
  fileUid: string,
  name?: string,
  cardCover?: boolean,
  options?: OperationOptions,
) => Promise<RestrictedAccessCardFilesUpdateCardFileResponse>;

Path parameters

FieldTypePresence
card_uidstring (uuid)Required
idstring (uuid)Required

Query parameters

none.

Request body

FieldTypePresence
namestringOptional
card_coverbooleanOptional

Response: Object. Fields: 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 documentation.

...args: RestrictedAccessCommentFilesAttachFileToCommentParams

ts
declare const attachFileToComment: (
  cardUid: string,
  commentUid: string,
  file: Blob,
  options?: FileUploadOptions,
) => Promise<RestrictedAccessCommentFilesAttachFileToCommentResponse>;

Path parameters

FieldTypePresence
card_uidstring (uuid)Required
comment_uidstring (uuid | new)Required

Query parameters

none.

Request body

FieldTypePresence
fileBlobRequired

Response: Object. Fields: 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 documentation.

...args: RestrictedAccessCommentFilesDeleteCommentFileParams

ts
declare const deleteCommentFile: (
  cardUid: string,
  commentUid: string,
  fileUid: string,
  options?: OperationOptions,
) => Promise<RestrictedAccessCommentFilesDeleteCommentFileResponse>;

Path parameters

FieldTypePresence
card_uidstring (uuid)Required
comment_uidstring (uuid | new)Required
idstring (uuid)Required

Query parameters

none.

Response: Object. Fields: id.

getCommentFile ​

client.restrictedAccessCommentFiles.getCommentFile · GET /api/latest/cards/{card_uid}/comments/{comment_uid}/files/{id}

Get comment file. Kaiten documentation.

...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
  >;
};

Path parameters

FieldTypePresence
card_uidstring (uuid)Required
comment_uidstring (uuid | new)Required
idstring (uuid)Required

Query parameters

FieldTypePresence
redirectbooleanOptional
downloadbooleanOptional

Response: Object. Fields: 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 documentation.

...args: RestrictedAccessCommentFilesUpdateCommentFileParams

ts
declare const updateCommentFile: (
  cardUid: string,
  commentUid: string,
  fileUid: string,
  body: RestrictedAccessCommentFilesUpdateCommentFileBody,
  options?: OperationOptions,
) => Promise<RestrictedAccessCommentFilesUpdateCommentFileResponse>;

Path parameters

FieldTypePresence
card_uidstring (uuid)Required
comment_uidstring (uuid | new)Required
idstring (uuid)Required

Query parameters

none.

Request body

FieldTypePresence
namestringOptional
card_coverbooleanOptional

Response: Object. Fields: 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 documentation.

...args: RestrictedAccessCustomPropertyFilesAttachFileToCustomPropertyParams

ts
declare const attachFileToCustomProperty: (
  cardUid: string,
  propertyUid: string,
  file: Blob,
  options?: FileUploadOptions,
) => Promise<RestrictedAccessCustomPropertyFilesAttachFileToCustomPropertyResponse>;

Path parameters

FieldTypePresence
card_uidstring (uuid)Required
property_uidstring (uuid)Required

Query parameters

none.

Request body

FieldTypePresence
fileBlobRequired

Response: Object. Fields: 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 documentation.

...args: RestrictedAccessCustomPropertyFilesDeleteCustomPropertyFileParams

ts
declare const deleteCustomPropertyFile: (
  cardUid: string,
  propertyUid: string,
  fileUid: string,
  options?: OperationOptions,
) => Promise<RestrictedAccessCustomPropertyFilesDeleteCustomPropertyFileResponse>;

Path parameters

FieldTypePresence
card_uidstring (uuid)Required
property_uidstring (uuid)Required
idstring (uuid)Required

Query parameters

none.

Response: Object. Fields: id.

getCustomPropertyFile ​

client.restrictedAccessCustomPropertyFiles.getCustomPropertyFile · GET /api/latest/cards/{card_uid}/custom-properties/{property_uid}/files/{id}

Get custom property file. Kaiten documentation.

...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
  >;
};

Path parameters

FieldTypePresence
card_uidstring (uuid)Required
property_uidstring (uuid)Required
idstring (uuid)Required

Query parameters

FieldTypePresence
redirectbooleanOptional
downloadbooleanOptional

Response: Object. Fields: 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 documentation.

...args: RestrictedAccessCustomPropertyFilesUpdateCustomPropertyFileParams

ts
declare const updateCustomPropertyFile: (
  cardUid: string,
  propertyUid: string,
  fileUid: string,
  body: RestrictedAccessCustomPropertyFilesUpdateCustomPropertyFileBody,
  options?: OperationOptions,
) => Promise<RestrictedAccessCustomPropertyFilesUpdateCustomPropertyFileResponse>;

Path parameters

FieldTypePresence
card_uidstring (uuid)Required
property_uidstring (uuid)Required
idstring (uuid)Required

Query parameters

none.

Request body

FieldTypePresence
namestringOptional
card_coverbooleanOptional

Response: Object. Fields: 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 documentation.

...args: ServiceDeskServicesRetrieveServicesListParams

ts
declare const retrieveServicesList: (
  options?: OperationOptions,
) => Promise<ServiceDeskServicesRetrieveServicesListResponse>;

Path parameters

none.

Query parameters

none.

Response: Array. Fields: 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 documentation.

...args: SpaceBoardsCreateNewBoardParams

ts
declare const createNewBoard: (
  spaceId: number,
  body: SpaceBoardsCreateNewBoardBody,
  options?: OperationOptions,
) => Promise<SpaceBoardsCreateNewBoardResponse>;

Path parameters

FieldTypePresence
space_idintegerRequired

Query parameters

none.

Request body

FieldTypePresence
titlestring | numberRequired
columnsarray of objectOptional
lanesarray of objectOptional
descriptionstring | nullOptional
topintegerOptional
leftintegerOptional
default_card_type_idintegerOptional
first_image_is_coverbooleanOptional
reset_lane_spent_timebooleanOptional
automove_cardsbooleanOptional
backward_moves_enabledbooleanOptional
auto_assign_enabledbooleanOptional
sort_ordernumberOptional
external_idnumber | string | nullOptional

Response: Object. Fields: 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 documentation.

...args: SpaceBoardsGetBoardParams

ts
declare const getBoard: (
  spaceId: number,
  id: number,
  options?: OperationOptions,
) => Promise<SpaceBoardsGetBoardResponse>;

Path parameters

FieldTypePresence
space_idintegerRequired
idintegerRequired

Query parameters

none.

Response: Object. Fields: 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 documentation.

...args: SpaceBoardsGetListOfBoardsParams

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

Path parameters

FieldTypePresence
space_idintegerRequired

Query parameters

none.

Response: Array. Fields: 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 documentation.

...args: SpaceBoardsRemoveBoardParams

ts
declare const removeBoard: (
  spaceId: number,
  id: number,
  force?: boolean,
  options?: OperationOptions,
) => Promise<SpaceBoardsRemoveBoardResponse>;

Path parameters

FieldTypePresence
space_idintegerRequired
idintegerRequired

Query parameters

none.

Request body

FieldTypePresence
forcebooleanOptional

Response: Object. Fields: id.

updateBoard ​

client.spaceBoards.updateBoard · PATCH /api/latest/spaces/{space_id}/boards/{id}

Update board. Kaiten documentation.

...args: SpaceBoardsUpdateBoardParams

ts
declare const updateBoard: (
  spaceId: number,
  id: number,
  body: SpaceBoardsUpdateBoardBody,
  options?: OperationOptions,
) => Promise<SpaceBoardsUpdateBoardResponse>;

Path parameters

FieldTypePresence
space_idintegerRequired
idintegerRequired

Query parameters

none.

Request body

FieldTypePresence
titlestring | numberOptional
descriptionstring | nullOptional
topintegerOptional
leftintegerOptional
type1 | 5Optional
cell_wip_limitsarray of unknownOptional
default_card_type_idintegerOptional
default_tagsstring | nullOptional
first_image_is_coverbooleanOptional
reset_lane_spent_timebooleanOptional
automove_cardsbooleanOptional
backward_moves_enabledbooleanOptional
move_parents_to_donebooleanOptional
hide_done_policiesbooleanOptional
hide_done_policies_in_done_columnbooleanOptional
sort_ordernumberOptional
external_idnumber | string | nullOptional
move_from_space_idintegerOptional
auto_assign_enabledbooleanOptional
card_propertiesarray of object | nullOptional

Response: Object. Fields: 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 documentation.

...args: SpaceTemplateChecklistItemsCreateNewSpaceTemplateChecklistItemParams

ts
declare const createNewSpaceTemplateChecklistItem: (
  spaceUid: string,
  templateChecklistUid: string,
  text: string,
  sortOrder?: number,
  options?: OperationOptions,
) => Promise<SpaceTemplateChecklistItemsCreateNewSpaceTemplateChecklistItemResponse>;

Path parameters

FieldTypePresence
space_uidstringRequired
template_checklist_uidstringRequired

Query parameters

none.

Request body

FieldTypePresence
textstringRequired
sort_ordernumberOptional

Response: Object. Fields: 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 documentation.

...args: SpaceTemplateChecklistItemsRemoveSpaceTemplateChecklistItemParams

ts
declare const removeSpaceTemplateChecklistItem: (
  spaceUid: string,
  templateChecklistUid: string,
  itemUid: string,
  options?: OperationOptions,
) => Promise<SpaceTemplateChecklistItemsRemoveSpaceTemplateChecklistItemResponse>;

Path parameters

FieldTypePresence
space_uidstringRequired
template_checklist_uidstringRequired
item_uidstringRequired

Query parameters

none.

Response: Object. Fields: 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 documentation.

...args: SpaceTemplateChecklistItemsUpdateSpaceTemplateChecklistItemParams

ts
declare const updateSpaceTemplateChecklistItem: (
  spaceUid: string,
  templateChecklistUid: string,
  itemUid: string,
  body: SpaceTemplateChecklistItemsUpdateSpaceTemplateChecklistItemBody,
  options?: OperationOptions,
) => Promise<SpaceTemplateChecklistItemsUpdateSpaceTemplateChecklistItemResponse>;

Path parameters

FieldTypePresence
space_uidstringRequired
template_checklist_uidstringRequired
item_uidstringRequired

Query parameters

none.

Request body

FieldTypePresence
textstringOptional
sort_ordernumberOptional

Response: Object. Fields: 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 documentation.

...args: SpaceTemplateChecklistCreateNewSpaceTemplateChecklistParams

ts
declare const createNewSpaceTemplateChecklist: (
  spaceUid: string,
  name: string,
  sortOrder?: number,
  options?: OperationOptions,
) => Promise<SpaceTemplateChecklistCreateNewSpaceTemplateChecklistResponse>;

Path parameters

FieldTypePresence
space_uidstringRequired

Query parameters

none.

Request body

FieldTypePresence
namestringOptional
sort_ordernumberOptional

Response: Object. Fields: 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 documentation.

...args: SpaceTemplateChecklistGetListOfSpaceTemplateChecklistsParams

ts
declare const getListOfSpaceTemplateChecklists: (
  spaceUid: string,
  options?: OperationOptions,
) => Promise<SpaceTemplateChecklistGetListOfSpaceTemplateChecklistsResponse>;

Path parameters

FieldTypePresence
space_uidstringRequired

Query parameters

none.

Response: Array. Fields: 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 documentation.

...args: SpaceTemplateChecklistRemoveSpaceTemplateChecklistParams

ts
declare const removeSpaceTemplateChecklist: (
  spaceUid: string,
  templateChecklistUid: string,
  options?: OperationOptions,
) => Promise<SpaceTemplateChecklistRemoveSpaceTemplateChecklistResponse>;

Path parameters

FieldTypePresence
space_uidstringRequired
template_checklist_uidstringRequired

Query parameters

none.

Response: Object. Fields: uid.

updateSpaceTemplateChecklist ​

client.spaceTemplateChecklist.updateSpaceTemplateChecklist · PATCH /api/latest/spaces/{space_uid}/template-checklists/{template_checklist_uid}

Update space template checklist. Kaiten documentation.

...args: SpaceTemplateChecklistUpdateSpaceTemplateChecklistParams

ts
declare const updateSpaceTemplateChecklist: (
  spaceUid: string,
  templateChecklistUid: string,
  body: SpaceTemplateChecklistUpdateSpaceTemplateChecklistBody,
  options?: OperationOptions,
) => Promise<SpaceTemplateChecklistUpdateSpaceTemplateChecklistResponse>;

Path parameters

FieldTypePresence
space_uidstringRequired
template_checklist_uidstringRequired

Query parameters

none.

Request body

FieldTypePresence
namestringOptional
sort_ordernumberOptional
space_uidstringOptional

Response: Object. Fields: 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 documentation.

...args: SpaceUsersChangeUserRoleAndNotificationSettingsParams

ts
declare const changeUserRoleAndNotificationSettings: (
  spaceId: number,
  id: number,
  body: SpaceUsersChangeUserRoleAndNotificationSettingsBody,
  options?: OperationOptions,
) => Promise<SpaceUsersChangeUserRoleAndNotificationSettingsResponse>;

Path parameters

FieldTypePresence
space_idintegerRequired
idintegerRequired

Query parameters

none.

Request body

FieldTypePresence
role_idstringOptional
notifications_enabledbooleanOptional
space_group_idnumber | nullOptional
settingsobjectOptional

Response: Object. Fields: 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 documentation.

...args: SpaceUsersGetListOfUsersParams

ts
declare const getListOfUsers: (
  spaceId: number,
  query?: SpaceUsersGetListOfUsersQuery,
  options?: OperationOptions,
) => Promise<SpaceUsersGetListOfUsersResponse>;

Path parameters

FieldTypePresence
space_idintegerRequired

Query parameters

FieldTypePresence
include_inherited_accessbooleanOptional
inactivebooleanOptional
limitintegerOptional
last_user_idintegerOptional

Response: Array. Fields: 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 documentation.

...args: SpaceUsersGetUserParams

ts
declare const getUser: (
  spaceId: number,
  id: number,
  options?: OperationOptions,
) => Promise<SpaceUsersGetUserResponse>;

Path parameters

FieldTypePresence
space_idintegerRequired
idintegerRequired

Query parameters

none.

Response: Object. Fields: 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 documentation.

...args: SpaceUsersInviteUserToSpaceParams

ts
declare const inviteUserToSpace: (
  spaceId: number,
  body: SpaceUsersInviteUserToSpaceBody,
  options?: OperationOptions,
) => Promise<SpaceUsersInviteUserToSpaceResponse>;

Path parameters

FieldTypePresence
space_idintegerRequired

Query parameters

none.

Request body

FieldTypePresence
emailstringRequired
role_idstringOptional
guestbooleanOptional
operator_commentstringOptional
send_emailbooleanOptional

Response: Object. Fields: user, access_record, message.

removeUserFromSpace ​

client.spaceUsers.removeUserFromSpace · DELETE /api/latest/spaces/{space_id}/users/{id}

Remove user from space. Kaiten documentation.

...args: SpaceUsersRemoveUserFromSpaceParams

ts
declare const removeUserFromSpace: (
  spaceId: number,
  id: number,
  options?: OperationOptions,
) => Promise<SpaceUsersRemoveUserFromSpaceResponse>;

Path parameters

FieldTypePresence
space_idintegerRequired
idintegerRequired

Query parameters

none.

Response: Object. Fields: 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 documentation.

...args: SpacesCreateNewSpaceParams

ts
declare const createNewSpace: (
  body: SpacesCreateNewSpaceBody,
  options?: OperationOptions,
) => Promise<SpacesCreateNewSpaceResponse>;

Path parameters

none.

Query parameters

none.

Request body

FieldTypePresence
titlestring | numberRequired
external_idnumber | string | nullOptional
parent_entity_uidstringOptional
for_everyone_access_role_idstringOptional
sort_ordernumberOptional
work_calendar_idstringOptional

Response: Object. Fields: 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 documentation.

...args: SpacesRemoveSpaceParams

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

Path parameters

FieldTypePresence
space_idintegerRequired

Query parameters

none.

Response: Object. Fields: id.

retrieveListOfSpaces ​

client.spaces.retrieveListOfSpaces · GET /api/latest/spaces

Retrieve list of spaces. Kaiten documentation.

...args: SpacesRetrieveListOfSpacesParams

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

Path parameters

none.

Query parameters

FieldTypePresence
limitintegerOptional
offsetintegerOptional

Response: Array. Fields: 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 documentation.

...args: SpacesRetrieveSpaceParams

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

Path parameters

FieldTypePresence
space_idintegerRequired

Query parameters

none.

Response: Object. Fields: 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 documentation.

...args: SpacesUpdateSpaceParams

ts
declare const updateSpace: (
  spaceId: number,
  body: SpacesUpdateSpaceBody,
  options?: OperationOptions,
) => Promise<SpacesUpdateSpaceResponse>;

Path parameters

FieldTypePresence
space_idintegerRequired

Query parameters

none.

Request body

FieldTypePresence
titlestring | numberOptional
external_idnumber | string | nullOptional
hidden_card_type_uidsarray of stringOptional
settingsobjectOptional
accessfor_everyone | by_inviteOptional
parent_entity_uidstring | nullOptional
sort_ordernumberOptional

Response: Object. Fields: 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 documentation.

...args: SprintsGetSprintSummaryParams

ts
declare const getSprintSummary: (
  id: number,
  excludeDeletedCards?: boolean,
  options?: OperationOptions,
) => Promise<SprintsGetSprintSummaryResponse>;

Path parameters

FieldTypePresence
idintegerRequired

Query parameters

FieldTypePresence
exclude_deleted_cardsbooleanOptional

Response: Object. Fields: 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 documentation.

...args: SprintsGetSprintsListParams

ts
declare const getSprintsList: (
  active?: boolean,
  limit?: number,
  offset?: number,
  options?: OperationOptions,
) => Promise<SprintsGetSprintsListResponse>;

Path parameters

none.

Query parameters

FieldTypePresence
activebooleanOptional
limitintegerOptional
offsetintegerOptional

Response: Array. Fields: 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 documentation.

...args: SubcolumnCreateNewSubcolumnParams

ts
declare const createNewSubcolumn: (
  columnId: number,
  body: SubcolumnCreateNewSubcolumnBody,
  options?: OperationOptions,
) => Promise<SubcolumnCreateNewSubcolumnResponse>;

Path parameters

FieldTypePresence
column_idintegerRequired

Query parameters

none.

Request body

FieldTypePresence
external_idnumber | string | nullOptional
titlestringRequired
sort_ordernumberOptional
type1 | 2 | 3Optional
archive_after_daysintegerOptional
months_to_hide_cardsinteger | nullOptional
card_hide_after_daysinteger | nullOptional
col_countintegerOptional
rulesintegerOptional
last_moved_warning_after_minutesintegerOptional
last_moved_warning_after_hoursintegerOptional
last_moved_warning_after_daysintegerOptional

Response: Object. Fields: 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 documentation.

...args: SubcolumnGetListOfSubcolumnsParams

ts
declare const getListOfSubcolumns: (
  columnId: number,
  options?: OperationOptions,
) => Promise<SubcolumnGetListOfSubcolumnsResponse>;

Path parameters

FieldTypePresence
column_idintegerRequired

Query parameters

none.

Response: Array. Fields: 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 documentation.

...args: SubcolumnRemoveSubcolumnParams

ts
declare const removeSubcolumn: (
  columnId: number,
  subcolumnId: number,
  force?: boolean,
  options?: OperationOptions,
) => Promise<SubcolumnRemoveSubcolumnResponse>;

Path parameters

FieldTypePresence
column_idintegerRequired
idintegerRequired

Query parameters

none.

Request body

FieldTypePresence
forcebooleanOptional

Response: Object. Fields: id.

updateSubcolumn ​

client.subcolumn.updateSubcolumn · PATCH /api/latest/columns/{column_id}/subcolumns/{id}

Update subcolumn. Kaiten documentation.

...args: SubcolumnUpdateSubcolumnParams

ts
declare const updateSubcolumn: (
  columnId: number,
  subcolumnId: number,
  body: SubcolumnUpdateSubcolumnBody,
  options?: OperationOptions,
) => Promise<SubcolumnUpdateSubcolumnResponse>;

Path parameters

FieldTypePresence
column_idintegerRequired
idintegerRequired

Query parameters

none.

Request body

FieldTypePresence
external_idnumber | string | nullOptional
titlestringOptional
sort_ordernumberOptional
type1 | 2 | 3Optional
archive_after_daysintegerOptional
months_to_hide_cardsinteger | nullOptional
card_hide_after_daysinteger | nullOptional
col_countintegerOptional
rulesintegerOptional
default_tagsstring | nullOptional
last_moved_warning_after_minutesintegerOptional
last_moved_warning_after_hoursintegerOptional
last_moved_warning_after_daysintegerOptional
prev_column_idinteger | nullOptional
next_column_idinteger | nullOptional
pause_slabooleanOptional

Response: Object. Fields: 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 documentation.

...args: TagsAddTagParams

ts
declare const addTag: (
  name: string,
  query?: TagsAddTagQuery,
  options?: OperationOptions,
) => Promise<TagsAddTagResponse>;

Path parameters

none.

Query parameters

FieldTypePresence
idsstringOptional
querystringOptional
space_idintegerOptional
limitintegerOptional
offsetintegerOptional

Request body

FieldTypePresence
namestringRequired

Response: Object. Fields: created, updated, id, name, company_id, color, archived.

retrieveListOfTags ​

client.tags.retrieveListOfTags · GET /api/latest/tags

The client accepts ids as a string or a readonly numeric array (QueryList<number>).

Retrieve list of tags. Kaiten documentation.

...args: TagsRetrieveListOfTagsParams

ts
declare const retrieveListOfTags: (
  query?: TagsRetrieveListOfTagsQuery,
  options?: OperationOptions,
) => Promise<TagsRetrieveListOfTagsResponse>;

Path parameters

none.

Query parameters

FieldTypePresence
limitintegerOptional
offsetintegerOptional
space_idintegerOptional
idsstringOptional
querystringOptional

Response: Array. Fields: created, updated, id, name, company_id, color, archived.

timesheet ​

getList ​

client.timesheet.getList · GET /api/latest/time-logs

The client accepts the eight comma-separated ID filters as strings or readonly numeric arrays (QueryList<number>).

Get list. Kaiten documentation.

...args: TimesheetGetListParams

ts
declare const getList: (
  query: TimesheetGetListQuery,
  options?: OperationOptions,
) => Promise<TimesheetGetListResponse>;

Path parameters

none.

Query parameters

FieldTypePresence
fromstringRequired
tostringRequired
tag_idsstringOptional
user_idsstringOptional
group_idsstringOptional
space_idsstringOptional
board_idsstringOptional
column_idsstringOptional
card_idsstringOptional
visible_column_idsstringOptional
limitintegerOptional
offsetintegerOptional
conditionintegerOptional
group_byintegerOptional
time_precisionintegerOptional
time_unitintegerOptional
with_daily_distributionintegerOptional
only_general_sumintegerOptional

Response: Array. Fields: 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 documentation. Beta.

...args: TreeEntitiesGetListOfEntitiesParams

ts
declare const getListOfEntities: (
  query?: TreeEntitiesGetListOfEntitiesQuery,
  options?: OperationOptions,
) => Promise<TreeEntitiesGetListOfEntitiesResponse>;

Path parameters

none.

Query parameters

FieldTypePresence
limitnumberOptional
offsetnumberOptional
parent_entity_uidstringOptional
levels_countnumberOptional

Response: Array. Fields: 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 documentation. Beta.

...args: TreeEntityRolesGetListOfTreeEntityRolesParams

ts
declare const getListOfTreeEntityRoles: (
  options?: OperationOptions,
) => Promise<TreeEntityRolesGetListOfTreeEntityRolesResponse>;

Path parameters

none.

Query parameters

none.

Response: Array. Fields: 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 documentation.

...args: UserRolesCreateUserRoleParams

ts
declare const createUserRole: (
  name: string,
  options?: OperationOptions,
) => Promise<UserRolesCreateUserRoleResponse>;

Path parameters

none.

Query parameters

none.

Request body

FieldTypePresence
namestringRequired

Response: Object. Fields: name, company_id, updated, created, id, uid.

getListOfUserRoles ​

client.userRoles.getListOfUserRoles · GET /api/latest/user-roles

Get list of user roles. Kaiten documentation.

...args: UserRolesGetListOfUserRolesParams

ts
declare const getListOfUserRoles: (
  options?: OperationOptions,
) => Promise<UserRolesGetListOfUserRolesResponse>;

Path parameters

none.

Query parameters

none.

Response: Array. Fields: created, updated, id, uid, name, company_id.

getUserRole ​

client.userRoles.getUserRole · GET /api/latest/user-roles/{role_id}

Get user role. Kaiten documentation.

...args: UserRolesGetUserRoleParams

ts
declare const getUserRole: (
  roleId: number,
  options?: OperationOptions,
) => Promise<UserRolesGetUserRoleResponse>;

Path parameters

FieldTypePresence
role_idintegerRequired

Query parameters

none.

Response: Object. Fields: name, company_id, updated, created, id, uid.

removeUserRole ​

client.userRoles.removeUserRole · DELETE /api/latest/user-roles/{role_id}

Remove user role. Kaiten documentation.

...args: UserRolesRemoveUserRoleParams

ts
declare const removeUserRole: (
  roleId: number,
  replaceRoleId: number,
  options?: OperationOptions,
) => Promise<UserRolesRemoveUserRoleResponse>;

Path parameters

FieldTypePresence
role_idintegerRequired

Query parameters

none.

Request body

FieldTypePresence
replace_role_idintegerRequired

Response: Object. Fields: name, company_id, updated, created, id, uid.

updateUserRole ​

client.userRoles.updateUserRole · PATCH /api/latest/user-roles/{role_id}

Update user role. Kaiten documentation.

...args: UserRolesUpdateUserRoleParams

ts
declare const updateUserRole: (
  roleId: number,
  name: string,
  options?: OperationOptions,
) => Promise<UserRolesUpdateUserRoleResponse>;

Path parameters

FieldTypePresence
role_idintegerRequired

Query parameters

none.

Request body

FieldTypePresence
namestringRequired

Response: Object. Fields: name, company_id, updated, created, id, uid.

users ​

retrieveCurrentUser ​

client.users.retrieveCurrentUser · GET /api/latest/users/current

Retrieve current user. Kaiten documentation.

...args: UsersRetrieveCurrentUserParams

ts
declare const retrieveCurrentUser: (
  options?: OperationOptions,
) => Promise<UsersRetrieveCurrentUserResponse>;

Path parameters

none.

Query parameters

none.

Response: Object. Fields: 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

The client accepts ids as a string or a readonly numeric array (QueryList<number>).

Retrieve list of users. Kaiten documentation.

...args: UsersRetrieveListOfUsersParams

ts
declare const retrieveListOfUsers: (
  query?: UsersRetrieveListOfUsersQuery,
  options?: OperationOptions,
) => Promise<UsersRetrieveListOfUsersResponse>;

Path parameters

none.

Query parameters

FieldTypePresence
typestringOptional
querystringOptional
access_type_permissionsstringOptional
idsstringOptional
limitintegerOptional
offsetintegerOptional
include_inactivebooleanOptional
exclude_directly_added_members_by_entity_uidstringOptional
exclude_members_by_entity_uidstringOptional

Response: Array. Fields: 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 documentation.

...args: UsersUpdateUserParams

ts
declare const updateUser: (
  userId: number,
  body: UsersUpdateUserBody,
  options?: OperationOptions,
) => Promise<UsersUpdateUserResponse>;

Path parameters

FieldTypePresence
idintegerRequired

Query parameters

none.

Request body

FieldTypePresence
usernamestringOptional
full_namestringOptional
initialsstringOptional
avatar_type1 | 2 | 3Optional
passwordstringOptional
old_passwordstring | nullOptional
lngstringOptional
default_space_idinteger | nullOptional
themelight | dark | autoOptional
email_frequency1 | 2Optional
timezonestringOptional
subject_by1 | 2Optional
email_settingsobjectOptional
telegram_settingsobjectOptional
slack_settingsobjectOptional
notification_enabled_channelsarray of inner | mobile_app | email | slack | telegramOptional
notification_settingsobjectOptional
ui_version1 | 2Optional

Response: Object. Fields: 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.