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.
We’re introducing the ability for apps to publish events, allowing for enhanced interoperability between apps. This feature enables apps to subscribe to events using the existing https://developer.atlassian.com/platform/forge/manifest-reference/modules/trigger/ module, opening up new possibilities for app interactions.
Developers can start using app events by implementing the https://developer.atlassian.com/platform/forge/manifest-reference/modules/event/ module in their apps. For detailed guidance and examples, refer to https://developer.atlassian.com/platform/forge/events-reference/app-events/.
To publish events using the runtime API, you need at least version 2.0.0
of the @forge/events
dependency. Add this to your package.json
:
1
2
3
4
5
{
"dependencies": {
"@forge/events": "^2.0.0"
}
}
A new getUrl
method has been added to router
in @forge/bridge
. The method will accept a NavigationLocation
object and return a URL object for the corresponding destination.
This method is in Preview. For more details, see the router documentation.
Run npm install --save @forge/bridge@latest
in your resource directory to install the latest version of Forge bridge.
We've added an openOnInsert
parameter for macros with classic configuration. This parameter allows you to control whether the configuration panel is automatically opened on macro insert, enhancing the user experience by providing more flexibility.
To use this feature, you must be on the latest @forge/cli
version 11.6.0
. For more information, see the macro module documentation.
Atlassian Team entities are now able to be modified via many existing Group APIs if a Team ID is passed instead of a Group ID. They will not be returned in search or lookup results. They can be fetched and modified by ID.
Rollout: Progressive rollout by tenant in progress
This will be visible from Cloud Admin APIs immediately after rollout. Jira and Confluence APIs will take longer to roll out.
Blob objects can now be sent and received via the events API. This enhancement allows for more efficient data handling and transmission within the API.
Update to the latest version of @forge/bridge
with npm install --save @forge/bridge@latest
On February 10th 2025, we announced the Deprecation of automation.atlassian.com incoming webhooks for Automation rules https://developer.atlassian.com/changelog/#CHANGE-2299. As of 30 May 2025, the legacy incoming webhook has now been deprecated.
We’ve started to gradually shut down the legacy endpoint across all customer sites. Rules recently triggered through legacy webhooks will now be marked with error icons.
To view impacted rules:
Open the automation rule list in Jira or Confluence.
Click on the ‘Trigger' filter and select the ‘Incoming webhook’ filter. All rules triggered by an incoming webhook will be shown.
Within these filtered rules, any which have recently been triggered through a legacy webhook will have a error icon next to their name. This shows which rules were unable to complete a successful run due to using the legacy URL.
To learn how to update these rules, you can read our support documentation.
Since incoming webhooks may be called from non-Atlassian systems that we don’t have access to, or aren’t aware of, rule owners will need to migrate impacted rules to the new endpoint manually, read our support documentation.
Atlassian font assets are now being preloaded by the Connect JS library (ACJS) to support consistent typography across Atlassian and Connect apps. These assets are served from dedicated design system CDN https://ds-cdn.prod-east.frontend.public.atl-paas.net
.
Connect apps using the standard all.js
ACJS bundle will now automatically pre-load:
atlassian-fonts.css
Atlassian Sans font files (e.g., AtlassianSans-latin.woff2
)
These files are delivered from the new ds-cdn
host. The change was previously gated and is now enabled for all Connect apps.
Apps with a strict Content Security Policy (CSP) must update their style-src
and font-src
directives to allow the new CDN host. Without this, CSP violations may block font and styles loading.
Update your CSP to include:
1
2
style-src https://ds-cdn.prod-east.frontend.public.atl-paas.net
font-src https://ds-cdn.prod-east.frontend.public.atl-paas.net
This change improves visual alignment with Atlassian’s visual refresh program. For further background, see:
We’ve added new Confluence product events for labels:
avi:confluence:created:label
avi:confluence:added:label
avi:confluence:removed:label
avi:confluence:deleted:label
You can use these events to invoke your Forge app function when label is created, added to an entity, removed from an entity, or deleted. For more details see https://developer.atlassian.com/platform/forge/events-reference/confluence/#labels.
With the Forge CLI 11.5.0 release, we've enhanced the Forge platform to let you specify the memory available to functions at runtime by setting the memoryMB
property in the Manifest (https://developer.atlassian.com/platform/forge/manifest-reference/#runtimev2) . Increasing the function memory also increases its CPU allocation. The memory value can now be set between 128 MB and 1,024 MB, doubling the previous limit of 512 MB. If you do not configure the function memory, the default memory allocation of 512MB applies to your function. This change helps address out-of-memory (OOM) issues by allowing higher memory allocation.
For more information on configuring Forge function memory, see https://developer.atlassian.com/platform/forge/manifest-reference/#runtimev2.
For details on the relationship between memory and CPU allocation, refer to the https://docs.aws.amazon.com/lambda/latest/dg/configuration-memory.html.
We’ve released a new module, Confluence page banner, which enables apps to add a banner to Confluence pages. This module is generally available.
This feature provides equivalent Forge functionality to the Connect Confluence atl.general web panel.
We are deprecating the following Atlassian Connect-related unscoped npm packages in favor of their @atlassian scoped equivalents.
Starting 23rd of June 2025, these packages will no longer be supported, and we recommend transitioning to the corresponding scoped packages instead.
The affected packages are:
old package name | new package name | latest version of new package |
---|---|---|
|
| |
|
| |
|
| |
|
| |
|
| |
|
| |
|
| |
|
|
The scoped packages maintain 100% API compatibility with their unscoped versions, ensuring a seamless migration experience. We recommend updating to the scoped versions as soon as possible before the deprecation date.
All of these packages are part of the Atlassian Connect ecosystem and are used for developing Connect apps. The scoped packages provide identical functionality but align with our standardized package naming conventions. This change helps ensure consistency across our npm ecosystem and improves package security.
To update your dependencies, replace the unscoped package names with their scoped equivalents in your package.json files.
If you encounter any issues during migration, please reach out through the Developer Community forums.
We’re notifying you regarding the use of API tokens. Starting November 22, 2025, Atlassian will implement rate limits for API tokens to ensure a consistent, reliable, and secure experience for all users.
If you are using API tokens, please review this documentation to learn more about the limits
In some circumstances, where integrations using API tokens heavily impact the stability of our platform, we reserve the right to enforce the limits at an earlier date. If you will be rate-limited before November 22, 2025, Atlassian will contact you directly.
The introduction of rate limits is a proactive measure to safeguard our platform's stability and security. Rate limits help ensure platform stability and reliability by preventing integrations from overloading Atlassian’s systems.
You can now specify what actions an API token has permission to perform. When you create an API token from your Atlassian account, you can select the scopes for the API token. This change enhances security by allowing you to define specific permissions for API tokens.
To create an API token with scopes:
Log in to https://id.atlassian.com/manage-profile/security/api-tokens.
Select Create API token with scopes.
Give your API token a name that describes its purpose.
Select an expiration date for the API token (1 to 365 days).
Select the app you’d like the API token to access.
Select the scopes to determine what the API token can do in Jira or Confluence.
Select Create.
Select Copy to clipboard, then paste the token to your script, or save it somewhere safe. You can't recover the API token after this step. We recommend saving your API token in a password manager.
For more information, see:
We’ve added 3 new Confluence bridge APIs to improve how Forge apps can interact with Live Docs. When editing a Live Doc or Page, the content within the editor can be ‘ahead’ of its latest snapshotted or published version. These new Confluence bridge APIs allow Forge apps to interact with that latest content in the editor, even if it hasn’t been snapshotted or versioned yet.
getEditorContent - Return an ADF object representing the latest editor content of an entire document.
getMacroContent - Return an ADF object of the current Forge extension macro.
updateMacroContent - Update the content of the current Forge macro.
Read more detailed documentation about these new Confluence bridge APIs here.
As of today May 1, 2025, the following deprecated Confluence REST API V1 endpoints have been removed from service. This means requests to these endpoints will result in a 410
error response. These endpoints have also been removed from REST API V1 documentation.
Get Content: https://developer.atlassian.com/cloud/confluence/rest/v1/api-group-content/#api-wiki-rest-api-content-get
Create Content: https://developer.atlassian.com/cloud/confluence/rest/v1/api-group-content/#api-wiki-rest-api-content-post
Get Content By ID: https://developer.atlassian.com/cloud/confluence/rest/v1/api-group-content/#api-wiki-rest-api-content-id-get
Update Content: https://developer.atlassian.com/cloud/confluence/rest/v1/api-group-content/#api-wiki-rest-api-content-id-put
Delete Content: https://developer.atlassian.com/cloud/confluence/rest/v1/api-group-content/#api-wiki-rest-api-content-id-delete
Get Content History: https://developer.atlassian.com/cloud/confluence/rest/v1/api-group-content/#api-wiki-rest-api-content-id-history-get
Get Attachments: https://developer.atlassian.com/cloud/confluence/rest/v1/api-group-content---attachments/#api-wiki-rest-api-content-id-child-attachment-get
Get Content Children: https://developer.atlassian.com/cloud/confluence/rest/v1/api-group-content---children-and-descendants/#api-wiki-rest-api-content-id-child-get
Get Content Children by Type: https://developer.atlassian.com/cloud/confluence/rest/v1/api-group-content---children-and-descendants/#api-wiki-rest-api-content-id-child-type-get
Get Content Comments: https://developer.atlassian.com/cloud/confluence/rest/v1/api-group-content-comments/#api-wiki-rest-api-content-id-child-comment-get
Get Label for Content: https://developer.atlassian.com/cloud/confluence/rest/v1/api-group-content-labels/#api-wiki-rest-api-content-id-label-get
Get Content Versions: https://developer.atlassian.com/cloud/confluence/rest/v1/api-group-content-versions/#api-wiki-rest-api-content-id-version-get
Get Content Version: https://developer.atlassian.com/cloud/confluence/rest/v1/api-group-content-versions/#api-wiki-rest-api-content-id-version-versionnumber-get
Get Inline Task based on Search Parameters: https://developer.atlassian.com/cloud/confluence/rest/v1/api-group-inline-tasks/#api-wiki-rest-api-inlinetasks-search-get
Get Inline Task based on Global ID: https://developer.atlassian.com/cloud/confluence/rest/v1/api-group-inline-tasks/#api-wiki-rest-api-inlinetasks-inlinetaskid-get
Get Spaces: https://developer.atlassian.com/cloud/confluence/rest/v1/api-group-space/#api-wiki-rest-api-space-get
Get Content for Space: https://developer.atlassian.com/cloud/confluence/rest/v1/api-group-space/#api-wiki-rest-api-space-spacekey-content-get
Get Content for Space by Type: https://developer.atlassian.com/cloud/confluence/rest/v1/api-group-space/#api-wiki-rest-api-space-spacekey-content-type-get
All Space Properties endpoints: https://developer.atlassian.com/cloud/confluence/rest/v1/api-group-space-properties/#api-wiki-rest-api-space-spacekey-property-get
All Content Property endpoints: https://developer.atlassian.com/cloud/confluence/rest/v1/api-group-content-properties/
Update inline task given global ID: https://developer.atlassian.com/cloud/confluence/rest/v1/api-group-inline-tasks/#api-wiki-rest-api-inlinetasks-inlinetaskid-put
Please refer to our deprecation notices https://ecosystem.atlassian.net/browse/CHANGE-864 and https://ecosystem.atlassian.net/browse/CHANGE-1116
Rate this page: