the confluence python sdk has decommissioned confluence_client. get_page_id(space_key, title)

The confluence python sdk has decommissioned this function in the latest release. confluence_client.get_page_id(space_key, title) hence our job is failing.

Second, I see that the atlassian-python-api is being rolloed out every day - Who can confirm that when to expect a Stable release?

As we are kind of highly depend on this and our pipelines are breaking as per the new change. Would really appriciate some support on this. Many thanks in advance.

Details - 'confluence_client.get_page_id(space_key, title)' has been decomissioned as per the recent V2 release and I want to know if you could help me with the following

What is the recomended function to get a Page Id ? If we have the title.
As a fallback I am using atlassian-python-api==4.0.4 as a last known stabel version AFAIU. Would love to take your guidence on the Stable release on V2?
Can I get a full list of the decomissioned functions if possible in V2 release ?

I'm using this for Confluence Cloud.

@dskdata

Hello @dskdata ,

get_page_id is persists in Server and DataCenter, will add in Cloud as well
could you a bit share snippets to verify compatiblity please?
Hm, I did not decoms, but let me compare v1 and v2 confluence api changes , let me support both in Cloud module.
Cheers,
Gt

Many thanks! This is how I'm trying to get the page id - when I have space name and page title with me.

confluence_client = Confluence(url, username=username, password=password, cloud=cloud)

page_id = confluence_client.get_page_id(space_key, title)

And I confirm that this is still working on version 4.0.4.

@dskdata

We're also experiencing this same issue. We're not on the Cloud offering at the moment and our code snippet is almost the same as @dskdata (it doesn't have the cloud=cloud bit). Our pipeline failed using the latest version (function returned None) but when I used version 4.0.7 it works as expected (function returned the page ID). Thanks for any help you can provide.

@gonchik

Let's wait for @gonchik to respond! The V2 release looks like a big change and let's see how it goes.

Can you try first try @catriona-bennett

get_page_by_title(space, title)
and verify what are you getting?

And share the response if possible?

@dskdata

@dskdata I agree. In the meantime, I did what you suggested and the results are interesting.
Using the latest release (5.0.3) I got this response:

{
    "results": [
        {
            "id": "111111111",
            "type": "page",
            "status": "current",
            "title": "Page Title",
            "position": 17,
            "extensions": {
                "position": 17
            },
            "_links": {
                "webui": "/spaces/<SPACE>/pages/111111111/Page+Title",
                "edit": "/pages/resumedraft.action?draftId=111111111&draftShareId=11a1e1b1-1111-1111-a111-1111bcac1111",
                "tinyui": "/x/AaAAA",
                "self": "[https://confluence.mine/rest/api/content/111111111](https://confluence.mine/rest/api/content/111111111)"
            },
            "_expandable": {
                "container": "/rest/api/space/<SPACE>",
                "metadata": "",
                "operations": "",
                "children": "/rest/api/content/111111111/child",
                "restrictions": "/rest/api/content/111111111/restriction/byOperation",
                "history": "/rest/api/content/111111111/history",
                "ancestors": "",
                "body": "",
                "version": "",
                "descendants": "/rest/api/content/111111111/descendant",
                "space": "/rest/api/space/<SPACE>",
                "relevantViewRestrictions": "/rest/api/content/111111111/restriction/relevantViewRestrictions"
            }
        }
    ],
    "start": 0,
    "limit": 25,
    "size": 1,
    "_links": {
        "self": "[https://confluence.mine/rest/api/content?spaceKey=<SPACE>&title=Page+Title&type=page](https://confluence.mine/rest/api/content?spaceKey=<SPACE>&title=Page+Title&type=page)",
        "base": "[https://confluence.mine](https://confluence.mine/)",
        "context": ""
    }
}

And using release 4.0.7 I got:

{
    "id": "111111111",
    "type": "page",
    "status": "current",
    "title": "Page Title",
    "position": 17,
    "extensions": {
        "position": 17
    },
    "_links": {
        "webui": "/spaces/<SPACE>/pages/111111111/Page+Title",
        "edit": "/pages/resumedraft.action?draftId=111111111&draftShareId=11a1e1b1-1111-1111-a111-1111bcac1111",
        "tinyui": "/x/AaAAA",
        "self": "[https://confluence.mine/rest/api/content/111111111](https://confluence.mine/rest/api/content/111111111)"
    },
    "_expandable": {
        "container": "/rest/api/space/<SPACE>",
        "metadata": "",
        "operations": "",
        "children": "/rest/api/content/111111111/child",
        "restrictions": "/rest/api/content/111111111/restriction/byOperation",
        "history": "/rest/api/content/111111111/history",
        "ancestors": "",
        "body": "",
        "version": "",
        "descendants": "/rest/api/content/111111111/descendant",
        "space": "/rest/api/space/<SPACE>",
        "relevantViewRestrictions": "/rest/api/content/111111111/restriction/relevantViewRestrictions"
    }
}

There is now more info being returned but the biggest difference is that the info being returned in 4.0.7 is now nested in results and that is possibly why get_page_by_id is no longer returning what we expect. Did you get a similar result?

Will wait to see what @gonchik responds with.

@catriona-bennett

@catriona-bennett The reason you aren't getting the id in version 5.0.3 because the function signature is incorrect.

def get_page_id(self, space, title, type="page"):
        """
        Provide content id from search result by title and space.
        :param space: SPACE key
        :param title: title
        :param type: type of content: Page or Blogpost. Defaults to page
        :return:
        """
        return (self.get_page_by_title(space, title, type=type) or {}).get("id")

It's treating the response as JSON.
And it returns, None because id is nested inside the results list, not at the root level of the JSON response.

Calling .get("id") directly on the response dictionary looks for "id" alongside "results" and "start", which doesn't exist.

What you can try is :

json_response = get_page_by_title(space, title)
page_id = json_response["results"][0]["id"]
# Output: "111111111"

@dskdata

Thanks @dskdata and yes, that's exactly the problem. Thanks for filling in the bit of information I missed! Your suggestion works fine and is what I'll use for now rather than pinning the version but I will continue to follow this issue, as am interested to see what @gonchik comes back with.

Thanks @dskdata and yes, that's exactly the problem. Thanks for filling in the bit of information I missed! Your suggestion works fine and is what I'll use for now rather than pinning the version but I will continue to follow this issue, as am interested to see what @gonchik comes back with.

I have added a FIX for the server issue : 5fb020c

@dskdata

Thanks @dskdata! I can see that your fix has now been merged but I will need to wait for the next release before I can use it.

@gonchik

I have added the missing methods here #1680 @gonchik awaiting for your review. Hopefully this would solve some of the existing breakpoints.

Navigation Menu

Repository navigation

the confluence python sdk has decommissioned confluence_client. get_page_id(space_key, title) #1658

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

the confluence python sdk has decommissioned confluence_client. get_page_id(space_key, title) #1658

Description

Activity

gonchik commented on Aug 19, 2026

dskdata commented on Aug 19, 2026

catriona-bennett commented on Aug 19, 2026

dskdata commented on Aug 20, 2026

catriona-bennett commented on Aug 20, 2026

dskdata commented on Aug 20, 2026

catriona-bennett commented on Aug 21, 2026

dskdata commented on Aug 24, 2026

catriona-bennett commented on Aug 25, 2026

dskdata commented on Sep 12, 2026

Metadata

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Issue actions