Confluence New Implementation is documented, but not available in a release

[tibeer]

Hi, I noticed, that the documentation mentions a "Confluence New Implementation" (https://atlassian-python-api.readthedocs.io/confluence.html#new-implementation) which is not available in the latest release version (4.0.7). Looks like the logic for it is still pending in a pull request: #1523

Took me some time to figure out, why I cannot import "ConfluenceCloud" - Of course you can't if its not present in the version :)

[sbates]

Can anyone speak to this issue? Are API 2 calls available? Our confluence automatically made a live doc instead of a published page and the api tool I've been developing hasn't been able to cope with this at all.

[iconbpv]

Following this up as well. The documentation misleads people into believing that the v2 endpoints are already implemented when in fact it's not.

[Fran-Rg]

Documentation is synced with master of the repo?

One alternative to get 4.0.8:

pip install git+https://github.com/atlassian-api/atlassian-python-api.git@master
# Or if you want something less unpredictable
pip install git+https://github.com/atlassian-api/atlassian-python-api.git@COMMIT_ID

But I wasn't really able to understand how the current implementation
https://github.com/atlassian-api/atlassian-python-api/blob/master/atlassian/confluence/cloud/__init__.py#L11-L18
is linked with:
https://developer.atlassian.com/cloud/confluence/rest/v2/api-group-admin-key/#api-group-admin-key

This is what I've ended up doing:

confluence = ConfluenceCloud(
            url=confluence_url,
            username=username,
            password=api_token,
            api_root="wiki/api",
            api_version="v2",
            cloud=True,
        )
confluence.get(confluence.resource_url("pages"), params={"limit": 1})

[benjah1]

Documentation is synced with master of the repo?

One alternative to get 4.0.8:

pip install git+https://github.com/atlassian-api/atlassian-python-api.git@master
# Or if you want something less unpredictable
pip install git+https://github.com/atlassian-api/atlassian-python-api.git@COMMIT_ID

But I wasn't really able to understand how the current implementation https://github.com/atlassian-api/atlassian-python-api/blob/master/atlassian/confluence/cloud/__init__.py#L11-L18 is linked with: https://developer.atlassian.com/cloud/confluence/rest/v2/api-group-admin-key/#api-group-admin-key

This is what I've ended up doing:

confluence = ConfluenceCloud(
            url=confluence_url,
            username=username,
            password=api_token,
            api_root="wiki/api",
            api_version="v2",
            cloud=True,
        )
confluence.get(confluence.resource_url("pages"), params={"limit": 1})

For the cloud, there is rest api v1 and v2, and their api path structure are not the same.
e.g. for getting the page,

• v1 is wiki/rest/api/content/{id}
• v2 is wiki/api/v2/pages/{id}

I've got to say, this new feature is completely not ready. Not only the structure is not right and some of the functions/apis it listed don't even exist - take 'export' for example.

To whoever can't wait to try this edge feature, consider yourselves warned.

[t0rb3n]

Can anyone help me? I am trying to access the Confluence API but I am hit with "Current user not permitted to use Confluence" which I assume is due to it being a scoped API token. How can I access Cloud Confluence with scoped API token?

EDIT: For service accounts you can only create scoped tokens which I assume only work on v2. BUT a normal user can still create unscoped API token via https://id.atlassian.com/manage-profile/security/api-tokens. And this seems to work on v1.
Please correct me if I am wrong here. Just sharing my findings.

[Zircoz]

Fixed in 6197404 (Aug 30 2025): The Confluence module was split into separate Cloud and Server classes. ConfluenceCloud and ConfluenceServer are now importable via from atlassian.confluence import ConfluenceCloud, ConfluenceServer. The Confluence class auto-selects the correct implementation based on the URL.