Many of my Forge apps are broken because Atlassian has jumped the gun and deprecated
@forge/ui-confluence on the assumption that v1 API endpoint access will be cutoff May 1st 2024. This has also broken the CLI linter and a few other issues I’m still attempting to bring to the attention of engineers at Atlassian (v12 to v13 below has more than only permission scope breaking changes).
@AshishShirode @HughWu what we need from Atlassian is to STOP any hint whatsoever of a deprecation date until v2 API parity for ALL endpoints is confirmed.
For the past 18 months there has been a 6 month deadline announced, followed by months of zero communication, and then as the timeline stress builds and developers flame the forums, Atlassian extends the date another 6 months. You’re doing this yet again.
This strategy (or lack thereof) is having compounding negative effects both internal and external.
eg below is a reply from Atlassian on my support ticket:
A few months ago, we rewrote the
useContentProperty hook to migrate the usage of Confluence API v1 to v2 as Confluence said the V1 endpoints will be deprecated soon. This was included in
forge/ui-confluence major version 13. This required an update to scopes as the v2 APIs use different scopes now.
This is also the reason why the latest version of the CLI has an error message about new required scopes.
To summarize, required permissions depend on the
- version 12 and below -
- version 13 and above -
- You can continue using
@forge/ui-confluence version 12 and ignore the lint errors in the CLI when deploying with
forge deploy --no-verify but please note this is not recommended way.
npm install @forge/ui-confluence@latest --save and update scopes to use
Below is from the changelog. Note that this changelog was posted Dec 12th 2023, while the OP on this thread was Dec 1st 2023.
The implementations of
useContentProperty hooks in
@forge/ui-confluence major version 12 and lower contain deprecated Confluence V1 REST APIs. The version 12 and earlier versions of these hooks will no longer function after May 1, 2024 due to the public access removal of these endpoints.
@forge/ui-confluence major version 13 and higher contain a rewrite of the
useContentProperty hooks using Confluence V2 REST APIs. UI Kit apps using these hooks will need to update to new major version for their apps to continue to function as expected after May 1, 2024.
Behaviour and usage of the hooks between version 12 and version 13 will remain the same, however because the Confluence V2 endpoints require different permission scopes, changes will be required in the app’s manifest.