From 8998df97441e6764800cd420fbb446f667dd6817 Mon Sep 17 00:00:00 2001
From: dipanjannet <dip.sit.saha@gmail.com>
Date: Sat, 12 Sep 2026 16:51:18 +0530
Subject: [PATCH] Add methods to retrieve page by title and get page ID using
 V2 API

---
 atlassian/confluence/cloud/cloud.py | 40 +++++++++++++++++++++++++++++
 1 file changed, 40 insertions(+)

diff --git a/atlassian/confluence/cloud/cloud.py b/atlassian/confluence/cloud/cloud.py
index 6e27f2a04..6777e4b52 100644
--- a/atlassian/confluence/cloud/cloud.py
+++ b/atlassian/confluence/cloud/cloud.py
@@ -248,6 +248,46 @@ def get_pages(
         except Exception as e:
             log.error(f"Failed to retrieve pages: {e}")
             raise
+    
+    def get_page_by_title(
+        self, space_key: str, title: str, body_format: str = "storage", **kwargs
+    ) -> Dict[str, Any]:
+        """
+        Get page by space key and title using the V2 API.
+        Resolves the space key to space_id and queries the V2 page endpoint.
+        Returns a dictionary with 'results' key containing matching pages
+        to maintain backward compatibility with V1 callers.
+        """
+        try:
+            space = self.get_space_by_key(space_key)
+        except Exception as e:
+            log.error(f"Failed to retrieve space with key '{space_key}': {e}")
+            return {"results": []}
+
+        if not space or "id" not in space:
+            return {"results": []}
+
+        pages = self.get_pages(
+            space_id=space["id"],
+            title=title,
+            status="current",
+            body_format=body_format,
+            limit=1,
+            **kwargs,
+        )
+        return {"results": pages if isinstance(pages, list) else []}
+
+
+    def get_page_id(self, space: str, title: str, type: str = "page") -> Optional[str]:
+        """
+        Get page ID by space key and title using the V2 API.
+        Returns the ID from the first result or None if not found.
+        """
+        res = self.get_page_by_title(space, title)
+        results = res.get("results", [])
+        if results:
+            return str(results[0]["id"])
+        return None
 
     def get_page_versions(
         self,