Client.databases.list() is deprecated

ramnes · Dec 4, 2021 · 0dbde96 · 0dbde96
1 parent c1f269d
commit 0dbde96
Showing 1 changed file with 9 additions and 1 deletion.
diff --git a/notion_client/api_endpoints.py b/notion_client/api_endpoints.py
@@ -116,7 +116,15 @@ def delete(self, block_id: str, **kwargs: Any) -> SyncAsync[Any]:
 
 class DatabasesEndpoint(Endpoint):
     def list(self, **kwargs: Any) -> SyncAsync[Any]:
-        """List all Databases shared with the authenticated integration."""
+        """List all Databases shared with the authenticated integration.
+
+        > ⚠️  **Search pages for more details**
+        >
+        > This endpoint is no longer recommended, use search instead. This endpoint will
+        > only return explicitly shared pages, while search will also return child pages
+        > within explicitly shared pages. This endpoint's results cannot be filtered,
+        > while search can be used to match on page title.
+        """
         return self.parent.request(
             path="databases",
             method="GET",