Backlog update: We’re discontinuing the following APIs
As part of our routine housekeeping to keep Backlog running smoothly for you, we’re clearing out a few APIs that we’ve seen a significant drop in access. This is all part of our effort to keep Backlog fresh, efficient, and ready to support you with the tools that matter most.
Key dates to remember
The following APIs will be removed after August 28, 2025. If you’re still using any of them, now’s the time to transition to the new alternatives listed in the API documentation.
Impacted APIs and their replacements
Here’s a quick overview of the APIs that are on their way out, along with their new counterparts. If you’re currently using any of these, please make sure to update your integrations:
|
Target API |
Method |
Deprecated URL |
Alternative URL |
|
GET |
/api/v2/groups |
/api/v2/teams |
|
|
POST |
/api/v2/groups |
/api/v2/teams ※ |
|
|
GET |
/api/v2/groups/:groupId |
/api/v2/teams/:teamId ※ |
|
|
PATCH |
/api/v2/groups/:groupId |
/api/v2/teams/:teamId ※ |
|
|
DELETE |
/api/v2/groups/:groupId |
/api/v2/teams/:teamId ※ |
|
|
GET |
/api/v2/statuses |
/api/v2/projects/:projectIdOrKey/statuses |
|
|
GET |
/api/v2/projects/:projectIdOrKey/groups |
/api/v2/projects/:projectIdOrKey/teams |
|
|
POST |
/api/v2/projects/:projectIdOrKey/groups |
/api/v2/projects/:projectIdOrKey/teams |
|
|
DELETE |
/api/v2/projects/:projectIdOrKey/groups |
/api/v2/projects/:projectIdOrKey/teams |
|
|
GET |
/api/v2/groups/:groupId/icon |
/api/v2/teams/:teamId/icon |
Note: The methods marked with ※ are only available for the legacy classic plan.
Impact on API client libraries
With the removal of these APIs, we’ll also be discontinuing support for our API client libraries Backlog4j and backlog-js. These libraries will no longer be available after the APIs are deleted.
How to know If you’re affected
If you have used any of the deprecated APIs within the last three months, you will receive an email notification starting today, August 28, 2024. This notification will include details on which APIs you’ve been using and how to transition to the new URLs.
Important note for iOS app users
iOS apps running versions earlier than 2.20.5 will no longer work after the APIs are removed. Please update to the latest version to ensure continued service without interruptions.
Need assistance?
We’re here to help! If you have any questions or run into any issues with the API discontinuation, please reach out to our support team. We appreciate your cooperation and are here to make this transition as smooth as possible.