Rate this page:
This page includes release notes and updates for Confluence Cloud app developers. Use this page to keep track of upcoming changes, deprecation notices, new features, and feature updates from Confluence Cloud.
For updates about changes to the Forge platform, see the Forge changelog in the Forge documentation.
You can also ask questions and learn from other Confluence Cloud developers on the Atlassian Developer Community.
You can now use the following endpoints in the Confluence REST API v2:
Content Properties
Tasks
Learn more by exploring https://developer.atlassian.com/cloud/confluence/rest/v2/intro/.
These granular endpoints correlate to more specific functions and allow you to be intentional about how you interact with Confluence data.
Content is broken down into specific types – so you can work with pages, blog posts, and more as discrete entities.
When retrieving bulk content, these granular endpoints also offer faster speeds (up to 30x). Our new cursor-based pagination allows quick iteration through content, instead of offset-based pagination.
This release includes support for Connect, OAuth 2.0 (3LO), and Forge apps.
You can see previous changelog entries related to Confluence Cloud REST API v2: one, two, three.
On January 18, 2023, we'll be extending the length of API tokens for Atlassian accounts, API keys, and Repository Access Tokens. This ensures new tokens and keys generated after this date are more secure and reliable. Tokens and keys created before January 18, 2023 won’t be affected.
You can now use the following endpoints in the Confluence REST API v2:
Attachment
Blog Post
Comment
Custom Content
Label
Page
Space
Space Properties
Version
Learn more by exploring https://developer.atlassian.com/cloud/confluence/rest/v2/intro/.
These granular endpoints correlate to more specific functions and allow you to be intentional about how you interact with Confluence data.
Content is broken down into specific types - so you can work with pages, blog posts, and more as discrete entities.
When retrieving bulk content, these granular endpoints also offer faster speeds (up to 30x). Our new cursor-based pagination allows quick iteration through content, instead of offset-based pagination.
This release includes support for Connect, OAuth 2.0 (3LO), and Forge apps.
You can see previous changelog entries related to Confluence Cloud REST API v2 here and here.
On the Apr 17, 2023, the value of the issuer claim of OAuth access and refresh tokens will be:
Updated from Auth0 (https://atlassian-account-prod.pus2.auth0.com/
)
Changed to the native Atlassian value (auth.atlassian.com
).
Currently, this is not specified in our API documentation. For this reason, we don’t expect you to verify OAuth token issuer claims as Auth0. We're giving 3 months for the deprecation period until Apr 17, 2023.
We are deprecating the Get user accountIds REST API in Confluence Cloud.
On July 12, 2023, the GET /wiki/rest/api/user/bulk/migration
endpoint will be removed. If you require this endpoint for GDPR-related migrations from usernames/userkeys to Atlassian Account IDs, make sure to complete them before this date.
In 2018, we deprecated usernames and user keys as valid forms of user identification in the REST API, in order to improve user privacy in accordance with GDPR. These forms of user identification were removed in April 2019.
We introduced this endpoint in March 2019 to enable developers to migrate these deprecated forms of identification to Atlassian Account IDs (AAIDs). Because its purpose is migration, it only supports user keys and usernames for users created before the GDPR-related deprecation was announced. Developers should have completed their migrations at this point, so we’re sunsetting this endpoint.
To streamline the cloud app assessment and procurement process for customers and Marketplace Partners, we plan to add a new Privacy & Security tab to each Marketplace cloud app listing.
You can start preparing information to fill out the new tab for your cloud apps using the questions documented here.
This new Privacy & Security tab will replace the Security Self Assessment for cloud apps. It will also replace the Security Self Assessment requirement for Cloud Fortified apps starting 6 months from when the API documentation and web form are released.
We will follow up in the coming weeks (estimate: February) with API documentation and more detailed information on the web form to submit responses for your Privacy & Security tabs. We plan to make the new tab live for customers in March 2023.
In the meantime, you can start preparing responses for the tab using the questions documented here.
For customers that have security, compliance, and privacy requirements, this new tab on Atlassian Marketplace will provide key details about cloud apps in a consistent and discoverable place. It will also help Marketplace Partners more easily showcase investments in cloud app privacy and security.
View the new documentation here.
In the developer console, you can now edit the target value of your Forge app alert. Previously, the alert was set at a target value of 99%. Now you can choose from a number of values between 99% and 60%.
For more information, see Manage app alerts.
Forge apps can now subscribe to new events related to Confluence pages, and comments.
Page:
Archived: avi:confluence:archived:page
Unarchived: avi:confluence:unarchived:page
Moved: avi:confluence:moved:page
Copied: avi:confluence:copied:page
Children reordered: avi:confluence:children_reordered:page
Comment:
Updated: avi:confluence:updated:comment
In addition to current events related to Confluence pages and blogs, comments, and spaces, Forge apps can now subscribe to Confluence attachment events.
Attachment:
Created: avi:confluence:created:attachment
Updated: avi:confluence:updated:attachment
Viewed: avi:confluence:viewed:attachment
Archived: avi:confluence:archived:attachment
Unarchived: avi:confluence:unarchived:attachment
For more information on the complete list of product events for Confluence on Forge, see Confluence events.
The Jira/Confluence Cloud First Releases for Ecosystem initiative has been renamed to Developer Canary Program and now includes an app to provide self-service capabilities for developers.
For more information on how to get started with the program, see the Developer Canary Program documentation.
To access the Developer Canary Program app for:
Jira Cloud, visit the app in Marketplace at Developer Assistant for Jira.
Confluence Cloud, visit the app in Marketplace at Developer Assistant for Confluence.
Connect on Forge apps can now use OAuth 2.0 to authenticate with Atlassian services (as an App via client credentials grant type).
To authenticate with OAuth 2.0:
In the Forge manifest.yaml
file, under app.connect
, add authentication type as oauth2
(default is jwt
). The App installation or App major upgrade will send the new OAuth client credentials through a lifecycle event.
Make OAuth 2.0 authenticated requests from Connect Frameworks:
StatusPage has been replaced by Developer Console as the metrics UI for Cloud Fortified apps. The StatusPage metrics UI was deprecated on October 24, 2022.
Added Germany as supported realm for Connect data residency.
Today, we are happy to announce the launch of the Early Access Program (EAP) of data residency realm migration for Connect apps. This EAP release includes a new realm migration service and associated APIs, which will enable you to start integration and testing to support migration of app data to match the parent product realm.
To quickly identify the current state of your Forge apps, the developer console now displays values, as well as charts, for each metric. For more information, see View app metrics.
You can now use the following endpoints in version 2 Confluence REST API:
Get space by id: https://developer.atlassian.com/cloud/confluence/rest/v2/api-group-space/#api-spaces-id-get
Get pages in space: https://developer.atlassian.com/cloud/confluence/rest/v2/api-group-space/#api-spaces-id-pages-get
Get blog posts in space: https://developer.atlassian.com/cloud/confluence/rest/v2/api-group-space/#api-spaces-id-blogposts-get
Learn more by exploring https://developer.atlassian.com/cloud/confluence/rest/v2/intro/.
These granular endpoints allow you to be more specific when interacting with Confluence data.
Content is broken down into specific types. You can work with pages, blog posts, and more, as discrete entities.
When retrieving bulk content, these granular endpoints also offer faster speeds (up to 30x). Our new cursor-based pagination allows quick iteration through content, instead of offset-based pagination.
This release includes support for Connect, OAuth 2.0 (3LO), and Forge apps.