-
General Improvements: Enhanced JSDoc documentation across the project for better clarity and developer experience.
-
Deprecation: Marked the
InstanceInformation.getLicense
method as deprecated. -
Deprecation: Marked the
Issues.getCreateIssueMeta
method as deprecated. -
Deprecation: Marked the
PageBeanFieldConfigurationDetails
class as deprecated. UsePaginated<FieldConfigurationDetails>
instead. -
Deprecation: Marked the
WorkflowUpdateResponse
andWorkflowCreateResponse
classes 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.getValidProjectKey
andProjectKeyAndNameValidation.getValidProjectName
fromunknown
tostring
for improved type safety and usability. -
Improvement: Added the
approximateLastUsed
parameter to theFilters.createFilter
method. -
Improvement: Added the
isSubstringMatch
parameter to theFilters.getFiltersPaginated
method. -
Improvement: Updated the
IssueComments.updateComment
method to allow passing a plain string for the comment instead of requiring a specific object format. -
Improvement: Added the
parentId
parameter to theIssueComments.deleteComment
method. -
Improvement: Added the
releasedProjectKeys
property to theProjects.updateProject
method. -
Improvement: Added the
avatarId
parameter to theIssuePriorities.createPriority
method. This parameter will replaceiconUrl
starting March 16, 2025. TheiconUrl
parameter is now marked as deprecated. -
Improvement: Added the
priorityName
andexpand
properties to theIssuePriorities.searchPriorities
method. -
Improvement: Added the
avatarId
parameter to theIssuePriorities.updatePriority
method. This parameter will replaceiconUrl
starting March 16, 2025. TheiconUrl
parameter is now marked as deprecated. -
Improvement: Added the
issueId
property to theUserSearch.findAssignableUsers
method. -
Improvement: Added the optional
skipNotFoundPrecomputations
property to theJqlFunctionsApps.updatePrecomputations
method. -
Improvement: Added the
failFast
parameter to theIssues.getIssue
method. -
Improvement: Added the
failFast
parameter to theIssueSearch.searchForIssuesUsingJql
method. -
Improvement: Added the
ari
andmetadata
parameters to theProjectComponents.createComponent
method. -
Improvement: Added the optional
componentSource
parameter to theProjectComponents.getProjectComponentsPaginated
method. -
Improvement: Added the optional
componentSource
parameter to theProjectComponents.getProjectComponents
method. -
Improvement: Added the
approvers
anddriver
parameters to theProjectVersions.createVersion
andProjectVersions.updateVersion
methods. -
Improvement: Replaced the
maxResults
property withmaxResult
in theUserSearch.findUserKeysByQuery
method. -
Improvement: Added the
extendAdminPermissions
parameter to the following methods in theDashboard
class:Dashboard.createDashboard
Dashboard.updateDashboard
Dashboard.copyDashboard
-
New Method: Added the
getCustomFieldsConfigurations
method to theIssueCustomFieldConfigurationApps
class. -
New Method: Added the
replaceCustomFieldOption
method to theIssueCustomFieldOptions
class. -
New Methods: Added the following methods to the
WorkflowSchemes
class:readWorkflowSchemes
: Retrieve workflow schemes.updateSchemes
: Update workflow schemes.updateWorkflowSchemeMappings
: Update workflow scheme mappings.
-
New Method: Added the
getNotificationSchemeForProject
method to theProjects
class. -
New Method: Added the
getBulkScreenTabs
method to theScreenTabs
class. -
New Method: Added the
deletePriority
method to theIssuePriorities
class. -
New Method: Added the
getPrecomputationsByID
method to theJqlFunctionsApps
class. -
New Methods: Added the following methods to the
Workflows
class: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
Issues
class: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
IssueSearch
class: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
IssueWorklogs
class:bulkDeleteWorklogs
: Delete multiple worklogs in bulk.bulkMoveWorklogs
: Move multiple worklogs in bulk.
-
New Method: Added the
evaluateJiraExpressionUsingEnhancedSearch
method to theJiraExpressions
class. -
New Method: Added the
findComponentsForProjects
method to theProjectComponents
class. -
New Methods: Added the following methods to the
ProjectVersions
class: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
getProjectUsagesForWorkflowScheme
method to theWorkflowSchemes
class. -
New Method: Added the
getWorkflowProjectIssueTypeUsages
method to theWorkflows
class. -
New Methods: Added the following methods to the
Status
class:getProjectIssueTypeUsagesForStatus
getProjectUsagesForStatus
getWorkflowUsagesForStatus
-
Fix: Updated the following methods in
Version2Client
andVersion3Client
to make theparameters
argument mandatory (as it should have been initially):IssueFieldConfigurations.createFieldConfiguration
IssueFieldConfigurations.createFieldConfigurationScheme
IssueLinks.linkIssues
IssueTypeSchemes.createIssueTypeScheme
IssueTypeSchemes.assignIssueTypeSchemeToProject
IssueTypeScreenSchemes.createIssueTypeScreenScheme
JQL.parseJqlQueries
TimeTracking.setSharedTimeTrackingConfiguration
WorkflowSchemeProjectAssociations.assignSchemeToProject
IssueTypes.createIssueType
IssueSearch.matchIssues
IssueSearch.searchForIssuesUsingJql
JiraExpressions.evaluateJiraExpression
Users.setUserColumns
Users.getUser
-
Fix: Improved the
Avatars.storeAvatar
method:- Added the
mimeType
parameter to specify the type of the uploaded avatar. - Updated the type of the
avatar
parameter fromany
toBuffer | ArrayBuffer | Uint8Array | any
for better type safety. - Set the default value of the
size
parameter to0
.
- Added the
-
Fix: Improved the
IssueTypes.createIssueTypeAvatar
method:- Added the
mimeType
parameter to specify the type of the uploaded avatar. - Added the
avatar
parameter with the typeBuffer | ArrayBuffer | Uint8Array
. - Set the default value of the
size
parameter to0
.
- Added the
-
Fix: Improved the
ProjectAvatars.createProjectAvatar
method:- Added the
mimeType
parameter to specify the type of the uploaded avatar. - Updated the type of the
avatar
parameter fromany
toBuffer | ArrayBuffer | Uint8Array | any
. - Set the default value of the
size
parameter to0
.
- Added the
-
Change: Removed the
filter
parameter from theJqlFunctionsApps.getPrecomputations
method (experimental method, not a breaking change). -
Change: Renamed
JiraExpressionEvaluateContextBean
toJiraExpressionEvaluateContext
. -
Improvement: Added type
string
for propertiesprojectId
in 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
number
for propertiesprojectIdOrKey
in 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.