Release v4.1.0
-
General Improvements: Enhanced JSDoc documentation across the project for better clarity and developer experience.
-
Deprecation: Marked the
InstanceInformation.getLicensemethod as deprecated. -
Deprecation: Marked the
Issues.getCreateIssueMetamethod as deprecated. -
Deprecation: Marked the
PageBeanFieldConfigurationDetailsclass as deprecated. UsePaginated<FieldConfigurationDetails>instead. -
Deprecation: Marked the
WorkflowUpdateResponseandWorkflowCreateResponseclasses as deprecated. -
New APIs: Added the following classes to support additional Jira APIs:
AppDataPolicies: Manage app access rule data policies, allowing developers to set and retrieve rules controlling app access (documentation).ClassificationLevels: Define and manage classification levels for sensitive information in Jira (documentation).IssueBulkOperations: Perform bulk operations on issues, such as moving multiple issues between projects or updating multiple fields in one request. For additional guidance, refer to Bulk operation APIs: additional examples and FAQ (documentation).Plans: Manage advanced roadmaps plans, including creating, duplicating, updating, archiving, and trashing plans (documentation).PrioritySchemes: Create, retrieve, update, and delete issue priority schemes to standardize prioritization across projects (documentation).ProjectClassificationLevels: View and manage classification levels within individual projects to ensure compliance with organizational standards (documentation).ServiceRegistry: Access and manage attributes related to Jira Service Management’s service registry, which helps organize and maintain services (documentation).TeamsInPlan: Configure settings for Atlassian and custom teams within advanced roadmaps plans, including creating, updating, and deleting team configurations (documentation).
-
Improvement: Changed the return type of
ProjectKeyAndNameValidation.getValidProjectKeyandProjectKeyAndNameValidation.getValidProjectNamefromunknowntostringfor improved type safety and usability. -
Improvement: Added the
approximateLastUsedparameter to theFilters.createFiltermethod. -
Improvement: Added the
isSubstringMatchparameter to theFilters.getFiltersPaginatedmethod. -
Improvement: Updated the
IssueComments.updateCommentmethod to allow passing a plain string for the comment instead of requiring a specific object format. -
Improvement: Added the
parentIdparameter to theIssueComments.deleteCommentmethod. -
Improvement: Added the
releasedProjectKeysproperty to theProjects.updateProjectmethod. -
Improvement: Added the
avatarIdparameter to theIssuePriorities.createPrioritymethod. This parameter will replaceiconUrlstarting March 16, 2025. TheiconUrlparameter is now marked as deprecated. -
Improvement: Added the
priorityNameandexpandproperties to theIssuePriorities.searchPrioritiesmethod. -
Improvement: Added the
avatarIdparameter to theIssuePriorities.updatePrioritymethod. This parameter will replaceiconUrlstarting March 16, 2025. TheiconUrlparameter is now marked as deprecated. -
Improvement: Added the
issueIdproperty to theUserSearch.findAssignableUsersmethod. -
Improvement: Added the optional
skipNotFoundPrecomputationsproperty to theJqlFunctionsApps.updatePrecomputationsmethod. -
Improvement: Added the
failFastparameter to theIssues.getIssuemethod. -
Improvement: Added the
failFastparameter to theIssueSearch.searchForIssuesUsingJqlmethod. -
Improvement: Added the
ariandmetadataparameters to theProjectComponents.createComponentmethod. -
Improvement: Added the optional
componentSourceparameter to theProjectComponents.getProjectComponentsPaginatedmethod. -
Improvement: Added the optional
componentSourceparameter to theProjectComponents.getProjectComponentsmethod. -
Improvement: Added the
approversanddriverparameters to theProjectVersions.createVersionandProjectVersions.updateVersionmethods. -
Improvement: Replaced the
maxResultsproperty withmaxResultin theUserSearch.findUserKeysByQuerymethod. -
Improvement: Added the
extendAdminPermissionsparameter to the following methods in theDashboardclass:Dashboard.createDashboardDashboard.updateDashboardDashboard.copyDashboard
-
New Method: Added the
getCustomFieldsConfigurationsmethod to theIssueCustomFieldConfigurationAppsclass. -
New Method: Added the
replaceCustomFieldOptionmethod to theIssueCustomFieldOptionsclass. -
New Methods: Added the following methods to the
WorkflowSchemesclass:readWorkflowSchemes: Retrieve workflow schemes.updateSchemes: Update workflow schemes.updateWorkflowSchemeMappings: Update workflow scheme mappings.
-
New Method: Added the
getNotificationSchemeForProjectmethod to theProjectsclass. -
New Method: Added the
getBulkScreenTabsmethod to theScreenTabsclass. -
New Method: Added the
deletePrioritymethod to theIssuePrioritiesclass. -
New Method: Added the
getPrecomputationsByIDmethod to theJqlFunctionsAppsclass. -
New Methods: Added the following methods to the
Workflowsclass:readWorkflows: Retrieve workflows.workflowCapabilities: Get workflow capabilities.createWorkflows: Create new workflows.validateCreateWorkflows: Validate workflow creation.updateWorkflows: Update existing workflows.validateUpdateWorkflows: Validate workflow updates.
-
New Methods: Added the following methods to the
Issuesclass:getBulkChangelogs: Retrieve changelogs for multiple issues in bulk.bulkFetchIssues: Fetch multiple issues in bulk.getCreateIssueMetaIssueTypes: Retrieve metadata for issue types when creating issues.getCreateIssueMetaIssueTypeId: Retrieve metadata for a specific issue type by ID when creating issues.getIssueLimitReport: Retrieve a report on issue limits.
-
New Methods: Added the following methods to the
IssueSearchclass:countIssues: Count issues matching a query.searchForIssuesIds: Search for issue IDs using a query.searchForIssuesUsingJqlEnhancedSearch: Search and reconcile issues using JQL.searchForIssuesUsingJqlEnhancedSearchPost: Search and reconcile issues using JQL via POST request.
-
New Methods: Added the following methods to the
IssueWorklogsclass:bulkDeleteWorklogs: Delete multiple worklogs in bulk.bulkMoveWorklogs: Move multiple worklogs in bulk.
-
New Method: Added the
evaluateJiraExpressionUsingEnhancedSearchmethod to theJiraExpressionsclass. -
New Method: Added the
findComponentsForProjectsmethod to theProjectComponentsclass. -
New Methods: Added the following methods to the
ProjectVersionsclass:deleteRelatedWork: Delete related work for a version.updateRelatedWork: Update related work for a version.createRelatedWork: Create related work for a version.getRelatedWork: Retrieve related work for a version.
-
New Method: Added the
getProjectUsagesForWorkflowSchememethod to theWorkflowSchemesclass. -
New Method: Added the
getWorkflowProjectIssueTypeUsagesmethod to theWorkflowsclass. -
New Methods: Added the following methods to the
Statusclass:getProjectIssueTypeUsagesForStatusgetProjectUsagesForStatusgetWorkflowUsagesForStatus
-
Fix: Updated the following methods in
Version2ClientandVersion3Clientto make theparametersargument mandatory (as it should have been initially):IssueFieldConfigurations.createFieldConfigurationIssueFieldConfigurations.createFieldConfigurationSchemeIssueLinks.linkIssuesIssueTypeSchemes.createIssueTypeSchemeIssueTypeSchemes.assignIssueTypeSchemeToProjectIssueTypeScreenSchemes.createIssueTypeScreenSchemeJQL.parseJqlQueriesTimeTracking.setSharedTimeTrackingConfigurationWorkflowSchemeProjectAssociations.assignSchemeToProjectIssueTypes.createIssueTypeIssueSearch.matchIssuesIssueSearch.searchForIssuesUsingJqlJiraExpressions.evaluateJiraExpressionUsers.setUserColumnsUsers.getUser
-
Fix: Improved the
Avatars.storeAvatarmethod:- Added the
mimeTypeparameter to specify the type of the uploaded avatar. - Updated the type of the
avatarparameter fromanytoBuffer | ArrayBuffer | Uint8Array | anyfor better type safety. - Set the default value of the
sizeparameter to0.
- Added the
-
Fix: Improved the
IssueTypes.createIssueTypeAvatarmethod:- Added the
mimeTypeparameter to specify the type of the uploaded avatar. - Added the
avatarparameter with the typeBuffer | ArrayBuffer | Uint8Array. - Set the default value of the
sizeparameter to0.
- Added the
-
Fix: Improved the
ProjectAvatars.createProjectAvatarmethod:- Added the
mimeTypeparameter to specify the type of the uploaded avatar. - Updated the type of the
avatarparameter fromanytoBuffer | ArrayBuffer | Uint8Array | any. - Set the default value of the
sizeparameter to0.
- Added the
-
Change: Removed the
filterparameter from theJqlFunctionsApps.getPrecomputationsmethod (experimental method, not a breaking change). -
Change: Renamed
JiraExpressionEvaluateContextBeantoJiraExpressionEvaluateContext. -
Improvement: Added type
stringfor propertiesprojectIdin parameters and models:- Model
Version - Parameter
GetFieldConfigurationSchemeProjectMapping - Parameter
GetHierarchy - Parameter
GetIssueTypeSchemeForProjects - Parameter
GetIssueTypeScreenSchemeProjectAssociations - Parameter
GetIssueTypesForProject - Parameter
GetProjectEmail - Parameter
GetWorkflowSchemeProjectAssociations - Parameter
UpdateProjectEmail
- Model
-
Improvement: Added type
numberfor propertiesprojectIdOrKeyin parameters and models:- Parameter
AddActorUsers - Parameter
ArchiveProject - Parameter
CreateProjectAvatar - Parameter
DeleteActor - Parameter
DeleteProject - Parameter
DeleteProjectAsynchronously - Parameter
DeleteProjectAvatar - Parameter
DeleteProjectProperty - Parameter
GetAllProjectAvatars - Parameter
GetAllStatuses - Parameter
GetFeaturesForProject - Parameter
GetProjectComponents - Parameter
GetProjectComponentsPaginated - Parameter
GetProjectProperty - Parameter
GetProjectPropertyKeys - Parameter
GetProjectRole - Parameter
GetProjectRoleDetails - Parameter
GetProjectRoles - Parameter
GetProjectVersions - Parameter
GetProjectVersionsPaginated - Parameter
Restore - Parameter
SetActors - Parameter
SetProjectProperty - Parameter
ToggleFeatureForProject - Parameter
UpdateProject - Parameter
UpdateProjectAvatar
- Parameter
- Special thanks to Ness Li (nessgor) for implementing the changes above. PR: #356.
- Thanks to Niklas Correnz (uncaught) for reporting the issue: #352.