# Change Log The YouTrack Workflow API uses a versioning scheme that informs you from which version of YouTrack extended functionality is available. * For objects, methods, and properties that require a specific version of YouTrack or later, the earliest minimum version (including build number) is provided. * For features that have been deprecated, the latest supported version is shown. The workflow API itself is available from YouTrack version 2017.3. ## 2026.2 Added function [Connection.deleteAsync(uri, queryParams, handlerName)](v1-Connection.html#deleteAsync) Added function [Connection.doAsync(requestType, uri, queryParams, payload, handlerName)](v1-Connection.html#doAsync) Added function [Connection.getAsync(uri, queryParams, handlerName)](v1-Connection.html#getAsync) Added function [Connection.patchAsync(uri, queryParams, payload, handlerName)](v1-Connection.html#patchAsync) Added function [Connection.postAsync(uri, queryParams, payload, handlerName)](v1-Connection.html#postAsync) Added function [Connection.putAsync(uri, queryParams, payload, handlerName)](v1-Connection.html#putAsync) Added property [Issue.customerGroups](v1-Issue.html#property-customerGroups) Added property [Project.defaultVisibilityGroup](v1-Project.html#property-defaultVisibilityGroup) Added property [Project.iconUrl](v1-Project.html#property-iconUrl) Added property [User.type](v1-User.html#property-type) Added property [UserGroup.customerGroupProjects](v1-UserGroup.html#property-customerGroupProjects) Added property [UserGroup.isCustomerGroup](v1-UserGroup.html#property-isCustomerGroup) Added property [UserType.typeName](v1-UserType.html#property-typeName) Added type [UserType](v1-UserType.html) ## 2026.1 Added property [Article.permittedGroups](v1-Article.html#property-permittedGroups) Added property [Article.permittedUsers](v1-Article.html#property-permittedUsers) Added property [ArticleAttachment.created](v1-ArticleAttachment.html#property-created) Added property [BaseArticle.originalArticle](v1-BaseArticle.html#property-originalArticle) Added property [BaseArticleAttachment.author](v1-BaseArticleAttachment.html#property-author) Added property [BaseArticleAttachment.fileUrl](v1-BaseArticleAttachment.html#property-fileUrl) Added property [BaseArticleAttachment.isRemoved](v1-BaseArticleAttachment.html#property-isRemoved) Added property [BaseArticleAttachment.metaData](v1-BaseArticleAttachment.html#property-metaData) Added property [Issue.ccUsers](v1-Issue.html#property-ccUsers) Added property [Project.isTimeTrackingEnabled](v1-Project.html#property-isTimeTrackingEnabled) ## 2025.3.109000 Added type [LicenseInfo](v1-LicenseInfo.html) ## 2025.3 Added function [BundleProjectCustomField.getPossibleValuesForIssue(issue)](v1-BundleProjectCustomField.html#getPossibleValuesForIssue) Added function [Issue.setDefaultFieldValues()](v1-Issue.html#setDefaultFieldValues) Added function [Issue.tag(tag)](v1-Issue.html#tag) Added function [Issue.untag(tag)](v1-Issue.html#untag) Added function [Set.map(visitor)](v1-Set.html#map) Added function [Set.slice(start, end)](v1-Set.html#slice) Added function [Tag.canBeUsedForArticle(article, user)](v1-Tag.html#canBeUsedForArticle) Added function [Tag.canBeUsedForIssue(issue, user)](v1-Tag.html#canBeUsedForIssue) Added function [Tag.findByOwner(owner)](v1-Tag.html#findByOwner) Added function [User.hasPermission(permissionKey, project)](v1-User.html#hasPermission) Added function [User.isVotedForIssue(issue)](v1-User.html#isVotedForIssue) Added function [User.isWatchingIssue(issue)](v1-User.html#isWatchingIssue) Added function [UserProjectCustomField.getPossibleValuesForIssue(issue)](v1-UserProjectCustomField.html#getPossibleValuesForIssue) Added property [BundleProjectCustomField.valuesCondition](v1-BundleProjectCustomField.html#property-valuesCondition) Added property [FieldBasedBundleValuesCondition.conditions](v1-FieldBasedBundleValuesCondition.html#property-conditions) Added property [FieldBasedUserValuesCondition.conditions](v1-FieldBasedUserValuesCondition.html#property-conditions) Added property [FieldBasedValuesCondition.field](v1-FieldBasedValuesCondition.html#property-field) Added property [Issue.draftId](v1-Issue.html#property-draftId) Added property [Issue.watchers](v1-Issue.html#property-watchers) Added property [Project.sharedChangesProcessors](v1-Project.html#property-sharedChangesProcessors) Added property [ProjectTeam.project](v1-ProjectTeam.html#property-project) Added property [User.groups](v1-User.html#property-groups) Added property [User.pinnedSavedQueries](v1-User.html#property-pinnedSavedQueries) Added property [User.teams](v1-User.html#property-teams) Added property [UserCondition.bundleElement](v1-UserCondition.html#property-bundleElement) Added property [UserCondition.possibleValues](v1-UserCondition.html#property-possibleValues) Added property [UserProjectCustomField.valuesCondition](v1-UserProjectCustomField.html#property-valuesCondition) Added type [BundleElementCondition](v1-BundleElementCondition.html) Added type [FieldBasedBundleValuesCondition](v1-FieldBasedBundleValuesCondition.html) Added type [FieldBasedUserValuesCondition](v1-FieldBasedUserValuesCondition.html) Added type [FieldBasedValuesCondition](v1-FieldBasedValuesCondition.html) Added type [UserCondition](v1-UserCondition.html) ## 2025.2 Added function [BundleProjectCustomField.isValuePermittedInIssue(issue, value)](v1-BundleProjectCustomField.html#isValuePermittedInIssue) Added function [UserProjectCustomField.isValuePermittedInIssue(issue, value)](v1-UserProjectCustomField.html#isValuePermittedInIssue) Added property [PullRequest.idReadable](v1-PullRequest.html#property-idReadable) ## 2025.1 Added function [Issue.createDraft(project, reporter)](v1-Issue.html#createDraft) Added function [Issue.createSharedDraft(project)](v1-Issue.html#createSharedDraft) Added property [Article.url](v1-Article.html#property-url) ## 2024.4.52947 Added function [VcsChange.extractCommands(user)](v1-VcsChange.html#extractCommands) ## 2024.4 Added property [Article.childArticles](v1-Article.html#property-childArticles) Added property [Article.parentArticle](v1-Article.html#property-parentArticle) ## 2024.3.43260 Added function [Agile.findByExtensionProperties(extensionPropertiesQuery)](v1-Agile.html#findByExtensionProperties) Added function [Article.findByExtensionProperties(extensionPropertiesQuery)](v1-Article.html#findByExtensionProperties) Added function [ArticleAttachment.findByExtensionProperties(extensionPropertiesQuery)](v1-ArticleAttachment.html#findByExtensionProperties) Added function [ArticleComment.findByExtensionProperties(extensionPropertiesQuery)](v1-ArticleComment.html#findByExtensionProperties) Added function [Build.findByExtensionProperties(extensionPropertiesQuery)](v1-Build.html#findByExtensionProperties) Added function [BundleProjectCustomField.findByExtensionProperties(extensionPropertiesQuery)](v1-BundleProjectCustomField.html#findByExtensionProperties) Added function [Calendar24x7.findByExtensionProperties(extensionPropertiesQuery)](v1-Calendar24x7.html#findByExtensionProperties) Added function [EnumField.findByExtensionProperties(extensionPropertiesQuery)](v1-EnumField.html#findByExtensionProperties) Added function [FeedbackForm.findByExtensionProperties(extensionPropertiesQuery)](v1-FeedbackForm.html#findByExtensionProperties) Added function [Gantt.findByExtensionProperties(extensionPropertiesQuery)](v1-Gantt.html#findByExtensionProperties) Added function [GroupProjectCustomField.findByExtensionProperties(extensionPropertiesQuery)](v1-GroupProjectCustomField.html#findByExtensionProperties) Added function [Issue.findByExtensionProperties(extensionPropertiesQuery)](v1-Issue.html#findByExtensionProperties) Added function [IssueAttachment.findByExtensionProperties(extensionPropertiesQuery)](v1-IssueAttachment.html#findByExtensionProperties) Added function [IssueComment.findByExtensionProperties(extensionPropertiesQuery)](v1-IssueComment.html#findByExtensionProperties) Added function [IssueLinkPrototype.findByExtensionProperties(extensionPropertiesQuery)](v1-IssueLinkPrototype.html#findByExtensionProperties) Added function [IssueWorkItem.findByExtensionProperties(extensionPropertiesQuery)](v1-IssueWorkItem.html#findByExtensionProperties) Added function [MailboxChannel.findByExtensionProperties(extensionPropertiesQuery)](v1-MailboxChannel.html#findByExtensionProperties) Added function [OwnedField.findByExtensionProperties(extensionPropertiesQuery)](v1-OwnedField.html#findByExtensionProperties) Added function [PeriodProjectCustomField.findByExtensionProperties(extensionPropertiesQuery)](v1-PeriodProjectCustomField.html#findByExtensionProperties) Added function [PersistentFile.findByExtensionProperties(extensionPropertiesQuery)](v1-PersistentFile.html#findByExtensionProperties) Added function [Project.findByExtensionProperties(extensionPropertiesQuery)](v1-Project.html#findByExtensionProperties) Added function [ProjectTeam.findByExtensionProperties(extensionPropertiesQuery)](v1-ProjectTeam.html#findByExtensionProperties) Added function [ProjectType.findByExtensionProperties(extensionPropertiesQuery)](v1-ProjectType.html#findByExtensionProperties) Added function [ProjectVersion.findByExtensionProperties(extensionPropertiesQuery)](v1-ProjectVersion.html#findByExtensionProperties) Added function [PullRequest.findByExtensionProperties(extensionPropertiesQuery)](v1-PullRequest.html#findByExtensionProperties) Added function [PullRequestState.findByExtensionProperties(extensionPropertiesQuery)](v1-PullRequestState.html#findByExtensionProperties) Added function [SavedQuery.findByExtensionProperties(extensionPropertiesQuery)](v1-SavedQuery.html#findByExtensionProperties) Added function [SimpleCalendar.findByExtensionProperties(extensionPropertiesQuery)](v1-SimpleCalendar.html#findByExtensionProperties) Added function [SimpleProjectCustomField.findByExtensionProperties(extensionPropertiesQuery)](v1-SimpleProjectCustomField.html#findByExtensionProperties) Added function [Sprint.findByExtensionProperties(extensionPropertiesQuery)](v1-Sprint.html#findByExtensionProperties) Added function [State.findByExtensionProperties(extensionPropertiesQuery)](v1-State.html#findByExtensionProperties) Added function [Tag.findByExtensionProperties(extensionPropertiesQuery)](v1-Tag.html#findByExtensionProperties) Added function [TextProjectCustomField.findByExtensionProperties(extensionPropertiesQuery)](v1-TextProjectCustomField.html#findByExtensionProperties) Added function [User.findByExtensionProperties(extensionPropertiesQuery)](v1-User.html#findByExtensionProperties) Added function [UserGroup.findByExtensionProperties(extensionPropertiesQuery)](v1-UserGroup.html#findByExtensionProperties) Added function [UserProjectCustomField.findByExtensionProperties(extensionPropertiesQuery)](v1-UserProjectCustomField.html#findByExtensionProperties) Added function [VcsChange.findByExtensionProperties(extensionPropertiesQuery)](v1-VcsChange.html#findByExtensionProperties) Added function [WorkItemAttributeValue.findByExtensionProperties(extensionPropertiesQuery)](v1-WorkItemAttributeValue.html#findByExtensionProperties) Added function [WorkItemProjectAttribute.findByExtensionProperties(extensionPropertiesQuery)](v1-WorkItemProjectAttribute.html#findByExtensionProperties) Added function [WorkItemType.findByExtensionProperties(extensionPropertiesQuery)](v1-WorkItemType.html#findByExtensionProperties) ## 2024.3 Added property [BaseEntity.extensionProperties](v1-BaseEntity.html#property-extensionProperties) Added property [User.registered](v1-User.html#property-registered) ## 2024.2 Added function [Project.findWorkItemAttributeByName(name)](v1-Project.html#findWorkItemAttributeByName) Added function [WorkItemProjectAttribute.findValueByName(name)](v1-WorkItemProjectAttribute.html#findValueByName) Added property [IssueWorkItem.attributes](v1-IssueWorkItem.html#property-attributes) Added property [Project.workItemAttributes](v1-Project.html#property-workItemAttributes) Added property [WorkItemProjectAttribute.values](v1-WorkItemProjectAttribute.html#property-values) Added type [AppGlobalStorage](v1-AppGlobalStorage.html) Added type [WorkItemProjectAttribute](v1-WorkItemProjectAttribute.html) ## 2024.1 Added property [BaseArticle.pinnedComments](v1-BaseArticle.html#property-pinnedComments) Added property [BaseArticleComment.isPinned](v1-BaseArticleComment.html#property-isPinned) Added property [BaseComment.isPinned](v1-BaseComment.html#property-isPinned) Added property [Issue.pinnedComments](v1-Issue.html#property-pinnedComments) ## 2023.1 Added function [BaseArticle.addTag(name)](v1-BaseArticle.html#addTag) Added function [BaseArticle.hasTag(tagName)](v1-BaseArticle.html#hasTag) Added function [BaseArticle.removeTag(name)](v1-BaseArticle.html#removeTag) Added function [Issue.afterMinutes(initialTime, minutes, calendar, considerPauses)](v1-Issue.html#afterMinutes) Added function [Issue.pauseSLA()](v1-Issue.html#pauseSLA) Added function [Issue.resumeSLA()](v1-Issue.html#resumeSLA) Added function [Project.isAgent(user)](v1-Project.html#isAgent) Added function [User.notifyOnCase(caseName, parameters, projectDocument)](v1-User.html#notifyOnCase) Added function [User.unwatchArticle(article)](v1-User.html#unwatchArticle) Added function [User.watchArticle(article)](v1-User.html#watchArticle) Added property [Agile.currentSprint](v1-Agile.html#property-currentSprint) Added property [BaseArticle.isStarred](v1-BaseArticle.html#property-isStarred) Added property [BaseArticle.tags](v1-BaseArticle.html#property-tags) Added property [User.isEmailVerified](v1-User.html#property-isEmailVerified) Deprecated type [IssueTag](v1-IssueTag.html) ## 2022.2 Added property [User.isSystem](v1-User.html#property-isSystem) Added type [WorkItemAttributeValue](v1-WorkItemAttributeValue.html) ## 2022.1 Added function [md5(str)](v1-strings.html#md5) Added property [Issue.ganttCharts](v1-Issue.html#property-ganttCharts) Added property [Tag.permittedTagUserGroups](v1-Tag.html#property-permittedTagUserGroups) Added property [Tag.permittedTagUsers](v1-Tag.html#property-permittedTagUsers) Added property [User.isOnline](v1-User.html#property-isOnline) Added property [User.language](v1-User.html#property-language) Added type [Gantt](v1-Gantt.html) ## 2021.4.23500 Added function [Article.Article(author, project, summary)](v1-Article.html#Article) Added property [Project.articles](v1-Project.html#property-articles) Added type [Article](v1-Article.html) Added type [ArticleComment](v1-ArticleComment.html) Added type [BaseArticle](v1-BaseArticle.html) Added type [BaseArticleComment](v1-BaseArticleComment.html) ## 2021.4 Added function [Project.newDraft(reporter)](v1-Project.html#newDraft) ## 2021.2 Added function [VcsChange.getUrl(processor)](v1-VcsChange.html#getUrl) Added property [ChangesProcessor.url](v1-ChangesProcessor.html#property-url) Added property [IssueAttachment.base64Content](v1-IssueAttachment.html#property-base64Content) ## 2021.1.7000 Added property [User.attributes](v1-User.html#property-attributes) ## 2021.1.2300 Added function [IssueComment.isVisibleTo(user)](v1-IssueComment.html#isVisibleTo) ## 2021.1 Added property [PullRequest.url](v1-PullRequest.html#property-url) ## 2020.6.4500 Added property [IssueComment.deleted](v1-IssueComment.html#property-deleted) ## 2020.6.3400 Added function [IssueComment.addAttachment(content, name, charset, mimeType)](v1-IssueComment.html#addAttachment) ## 2020.6.3000 Added property [User.ringId](v1-User.html#property-ringId) ## 2020.5 Added property [BundleProjectCustomField.defaultValues](v1-BundleProjectCustomField.html#property-defaultValues) Added property [Issue.voters](v1-Issue.html#property-voters) ## 2020.3 Added property [ChangesProcessor.pullRequests](v1-ChangesProcessor.html#property-pullRequests) Added property [ChangesProcessor.vcsChanges](v1-ChangesProcessor.html#property-vcsChanges) Added property [Issue.pullRequests](v1-Issue.html#property-pullRequests) Added property [Project.changesProcessors](v1-Project.html#property-changesProcessors) Added property [PullRequest.previousState](v1-PullRequest.html#property-previousState) Added type [PullRequest](v1-PullRequest.html) Added type [PullRequestState](v1-PullRequestState.html) ## 2020.2 Added function [Article.addAttachment(content, name, charset, mimeType)](v1-Article.html#addAttachment) ## 2020.1.1331 Added function [VcsChange.isVisibleTo(user)](v1-VcsChange.html#isVisibleTo) ## 2019.3 Added property [User.avatarUrl](v1-User.html#property-avatarUrl) ## 2019.2.56440 Added property [IssueAttachment.fileUrl](v1-IssueAttachment.html#property-fileUrl) ## 2019.2.55603 Added function [BaseEntity.is(fieldName, expected)](v1-BaseEntity.html#is) Added function [BaseEntity.was(fieldName, expected)](v1-BaseEntity.html#was) ## 2019.2.53994 Added function [Issue.addAttachment(content, name, charset, mimeType)](v1-Issue.html#addAttachment) Added property [IssueAttachment.content](v1-IssueAttachment.html#property-content) Added property [PersistentFile.charset](v1-PersistentFile.html#property-charset) Added property [PersistentFile.mimeType](v1-PersistentFile.html#property-mimeType) ## 2019.1.50122 Added property [User.firstDayOfWeeks](v1-User.html#property-firstDayOfWeeks) ## 2018.2.45017 Added function [BundleProjectCustomField.createValue(name)](v1-BundleProjectCustomField.html#createValue) ## 2018.2.42881 Added function [after(timestamp, duration)](v1-date-time.html#after) Added function [before(timestamp, duration)](v1-date-time.html#before) ## 2018.2.42351 Added property [BaseEntity.isNew](v1-BaseEntity.html#property-isNew) Added property [PullRequest.isNew](v1-PullRequest.html#property-isNew) Added property [VcsChange.isNew](v1-VcsChange.html#property-isNew) ## 2018.2.42312 Added function [IssueWorkItem.delete()](v1-IssueWorkItem.html#delete) Added function [ProjectCustomField.becomesInvisibleInIssue(issue)](v1-ProjectCustomField.html#becomesInvisibleInIssue) Added function [ProjectCustomField.becomesVisibleInIssue(issue)](v1-ProjectCustomField.html#becomesVisibleInIssue) Added function [ProjectCustomField.isVisibleInIssue(issue)](v1-ProjectCustomField.html#isVisibleInIssue) ## 2018.2.41100 Added function [User.findByEmail(email)](v1-User.html#findByEmail) Added function [User.findUniqueByEmail(email)](v1-User.html#findUniqueByEmail) ## 2018.1.40030 Added function [IssueAttachment.delete()](v1-IssueAttachment.html#delete) Added property [BaseComment.attachments](v1-BaseComment.html#property-attachments) ## 2018.1.39547 Added function [Agile.getIssueSprints(issue)](v1-Agile.html#getIssueSprints) Added property [VcsChange.created](v1-VcsChange.html#property-created) Added property [VcsChange.fetched](v1-VcsChange.html#property-fetched) Deprecated property [VcsChange.date](v1-VcsChange.html#property-date) ## 2018.1.38923 Added function [IssueComment.delete()](v1-IssueComment.html#delete) Added property [AbstractVcsItem.branch](v1-AbstractVcsItem.html#property-branch) Added property [AbstractVcsItem.text](v1-AbstractVcsItem.html#property-text) Added property [AbstractVcsItem.user](v1-AbstractVcsItem.html#property-user) Added property [AbstractVcsItem.userName](v1-AbstractVcsItem.html#property-userName) Added property [ChangesProcessor.server](v1-ChangesProcessor.html#property-server) Added property [Issue.vcsChanges](v1-Issue.html#property-vcsChanges) Added property [VcsChange.changesProcessors](v1-VcsChange.html#property-changesProcessors) Added property [VcsChange.date](v1-VcsChange.html#property-date) Added property [VcsChange.id](v1-VcsChange.html#property-id) Added property [VcsChange.version](v1-VcsChange.html#property-version) Added property [VcsServer.url](v1-VcsServer.html#property-url) Added type [ChangesProcessor](v1-ChangesProcessor.html) Added type [VcsChange](v1-VcsChange.html) Added type [VcsServer](v1-VcsServer.html) ## 2017.4.38235 Added property [Project.team](v1-Project.html#property-team) ## 2017.4.37915 Added property [BaseEntity.becomesRemoved](v1-BaseEntity.html#property-becomesRemoved) ## 2017.4.37824 Added property [Issue.editedWorkItems](v1-Issue.html#property-editedWorkItems) ## See also [YouTrack Workflow API](YouTrack-Api-Documentation.html)