All notable changes to this project will be documented in this file. See standard-version for commit guidelines.
2.0 (UNRELEASED)
Version 2.0 is a bigger change with the main goal to make this library more reliable and future safe. See #489 for details.
For detailed migration instructions from v1.x to v2.0, see MIGRATE.md.
- Jira On-Premise and Jira Cloud have now different clients, because the API differs
client.NewRawRequestWithContext()has been removed in favor ofclient.NewRawRequest(), which requires now a context as first argumentclient.NewRequestWithContext()has been removed in favor ofclient.NewRequest(), which requires now a context as first argumentclient.NewMultiPartRequestWithContext()has been removed in favor ofclient.NewMultiPartRequest(), which requires now a context as first argumentcontextis now a first class citizen in all API calls. Functions that had a suffix like...WithContexthave been removed entirely. The API methods support the context now as first argument.BoardService.GetAllSprintshas been removed andBoardService.GetAllSprintsWithOptionshas been renamed toBoardService.GetAllSprintsGroupService.Gethas been removed andGroupService.GetWithOptionshas been renamed toGroupService.GetIssue.Updatehas been removed andIssue.UpdateWithOptionshas been renamed toIssue.UpdateIssue.GetCreateMetahas been removed andIssue.GetCreateMetaWithOptionshas been renamed toIssue.GetCreateMetaProject.GetListhas been removed andProject.ListWithOptionshas been renamed toProject.GetAll- Cloud/Authentication: Removed
BearerAuthTransport, because it was a (kind of) duplicate ofBasicAuthTransport - Cloud/Authentication: Removed
PATAuthTransport, because it was a (kind of) duplicate ofBasicAuthTransport - Cloud/Authentication:
BasicAuthTransport.Passwordwas renamed toBasicAuthTransport.APIToken - Cloud/Authentication: Removes
CookieAuthTransportandAuthenticationService, because this type of auth is not supported by the Jira cloud offering - Cloud/Component: The type
CreateComponentOptionswas renamed toComponentCreateOptions - Cloud/User: Renamed
User.GetSelftoUser.GetCurrentUser - Cloud/Group: Renamed
Group.AddtoGroup.AddUserByGroupName - Cloud/Group: Renamed
Group.RemovetoGroup.RemoveUserByGroupName
- UserAgent: Client HTTP calls are now identifable via a User Agent. This user agent can be configured (default:
go-jira/2.0.0) - The underlying used HTTP client for API calls can be retrieved via
client.Client() - API-Version: Official support for Jira Cloud API in version 3
- README: Fixed all (broken) links
- Workflow status categories: Revisited and fully implemented for Cloud and On Premise (incl. examples)
- Replace all "GET", "POST", ... with http.MethodGet (and related) constants
- Development: Added
makecommands to collect (unit) test coverage - Internal: Replaced
io.ReadAllandjson.Unmarshalwithjson.NewDecoder
1.17.0 (2025-09-16)
All changes in #735.
- Minimum Go version increased from 1.15 to 1.21 (due to google/go-cmp dependency update)
- Updated github.com/golang-jwt/jwt/v4 v4.4.2 to v4.5.2 (CVE-2025-30204)
- Replaced deprecated
ioutil.ReadFilewithos.ReadFile - Replaced deprecated
ioutil.ReadAllwithio.ReadAll - Replaced deprecated
ioutil.Discardwithio.Discard - Upgraded staticcheck v2022.1 to v2023.1
- Code formatting updates (issue.go, metaissue.go, sprint.go)
- github.com/google/go-cmp v0.5.8 to v0.7.0
- github.com/golang-jwt/jwt/v4 v4.4.2 to v4.5.2
- Upgraded actions/checkout from v3 to v5
- Upgraded actions/setup-go from v3 to v6
- Upgraded dominikh/staticcheck-action from v1.2 to v1.4
1.16.1 (2025-09-13)
- Added
IssueService.SearchV2JQL()andIssueService.SearchV2JQLWithContext()to handle Atlassian's deprecation ofGET /rest/api/2/searchendpoint (effective October 31, 2024) (#725)
New contributor: @conor-naranjo
1.16.0 (2022-07-08)
- Added example demonstrating how to add labels to issues (#442)
- Test matrix expanded to include macOS (#449)
- Deprecated Go v1.15 and Go v1.16; added Go v1.18 (#449)
- Implemented nightly CI runs (#449)
- Removed greetings workflow (#450)
- Upgraded staticcheck action to v1.2.0 (#451)
- github.com/golang-jwt/jwt/v4 v4.3.0 to v4.4.2 (#443, #445, #464)
- github.com/google/go-cmp v0.5.7 to v0.5.8 (#453)
- actions/checkout v2 to v3 (#448)
- actions/cache v2 to v3.0.1 (#447)
- actions/setup-go v2 to v3 (#452)
New contributor: @lucribas
1.15.1 (2022-02-26)
- Added customer and request endpoints for Service Desk API (#391)
- Added "environment" field to Issue struct (#440)
- User module improvements (#439)
- Added support for update section in DoTransitionWithPayload struct (#423)
- Fixed resource leaks (#399)
New contributors: @CondensedTea, @nansuri, @metalbreeze, @iamjem, @dustin-decker
1.15.0 (2022-02-18)
- Upgraded to JWT Library V4 (#403)
- Added Bearer token support for OAuth 2.0 (#397)
- Added Personal Access Token (PAT) authentication support (#422)
- Added method for updating remote issue links by ID (#411)
- Added support for ServiceDeskID as strings (#419)
- Added missing min/max properties to BoardConfigurationColumn (#430)
- Fixed missing struct omitempty tags in Parent struct (#435)
- Fixed import alias example in README (#428)
- github.com/golang-jwt/jwt/v4 v4.1.0 to v4.3.0 (#424, #438)
- github.com/google/go-cmp v0.5.6 to v0.5.7 (#432)
1.14.0 (2021-07-28)
- Added description field for component (#365)
- Added Jira ServiceDesk support with organizations (#342)
- Implemented delete issue link API (#341)
- Added Items and Custom properties to FieldSchema (#332)
- Added StartedAfter property to GetWorklogsQueryOptions (#344)
- Fixed potential nil reference issues (#342)
- Fixed context parameter propagation (#363)
- Fixed variable total calculation in pagination example (#354)
- Fixed boolean type handling for release versions (#336)
- Fixed RemoteLinkStatus (#303)
- Updated examples to use accountID instead of deprecated username (#374)
- Added example for creating issues with custom fields (#358)
- Fixed examples/create response output (#357)
- Added pagination example (#354)
- Switched examples from deprecated terminal.ReadPassword to term.ReadPassword (#359)
- CI/CD workflow cleanup (#384)
- Added funding information (#383)
- Upgraded to GitHub-native Dependabot (#375)
- Resolved nogo tautological linting error (#364)
- Updated Go versions in testing workflow (#349)
- JWT library upgrade (#387)
- github.com/google/go-cmp v0.3.0 to v0.5.6 (#347, #360, #379)
- github.com/pkg/errors v0.8.0 to v0.9.1 (#345)
- github.com/trivago/tgo v1.0.1 to v1.0.7 (#346)
- github.com/fatih/structs v1.0.0 to v1.1.0 (#348)
1.13.0 (2020-10-25)
- add AddRemoteLink method (f200e15), closes /developer.atlassian.com/cloud/jira/platform/rest/v2/#api-rest-api-2
- Add Names support on Issue struct (#278) (1fc10e0)
- Extend Makefile for more source code quality targets (5e52236)
- context: Add support for context package (e1f4265)
- issues: Add GetEditMeta on issue (a783764), closes /docs.atlassian.com/DAC/rest/jira/6.1.html#d2e1364
- IssueService: allow empty JQL (#268) (4b91cf2)
- project: Add cronjob to check for stale issues (#287) (2096b04)
- project: Add GitHub Actions testing workflow (#289) (80c0282), closes #290
- project: Add workflow to greet new contributors (#288) (c357b61)
- change millisecond time format (8c77107)
- paging with load balancer going to endless loop (19d3fc0), closes #260
- issue: IssueService.Search() with a not empty JQL triggers 400 bad request (#292) (8b64c7f), closes #291
- IssueService.GetWatchers: UserService.GetByAccountID support accountId params (436469b)
- product: Make product naming consistent, rename JIRA to Jira (#286) (146229d), closes #284
- tests: Fix TestIssueService_PostAttachment unit test (f6b1dca)
- removing the use of username field in searching for users (#297) (f50cb07)
1.12.0 (2019-12-14)
- Add IssueLinkTypeService with GetList and test (261889a)
- add worklog update method (9ff562a)
- Implement get remote links method (1946cac)
- Implement issue link type DELETE (e37cc6c)
- Implement issue link type GET (57538b9)
- Implement issue link type POST (75b9df8)
- Implement issue link type PUT (48a15c1)
- provide access to issue transitions loaded from JIRA API (7530b7c)
1.11.1 (2019-10-17)
1.11.0 (2019-10-17)
- Add AccountID and AccountType to GroupMember struct (216e005)
- Add AccountType and Locale to User struct (52ab347)
- Add GetAllStatuses (afc96b1)
- Add GetMyFilters to FilterService (ebae19d)
- Add Search to FilterService (38a755b)
- add support for JWT auth with qsh needed by add-ons (a8bdfed)
- AddGetBoardConfiguration (fd698c5)
- Replace http.Client with interface for extensibility (b59a65c)
1.10.0 (2019-05-23)
- empty SearchOptions causing malformed request (b3bf8c2)
- added DeleteAttachment (e93c0e1)
1.9.0 (2019-05-19)
- issues: Added support for AddWorklog and GetWorklogs (1ebd7e7)
1.8.0 (2019-05-16)
- Add PriorityService to the main (8491cb0)