feat(api): OpenAPI changes

Migration guides added to the paths

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 24
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/parallel-web%2Fparallel-sdk-57e1c56be0942c131ab5f24d8620de166d0721ef7f3423532abc7027e5a989e7.yml
-openapi_spec_hash: e61f831e30d19590eb3138a1b1709d1d
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/parallel-web%2Fparallel-sdk-3283d0ed1520a152928edc5dee967f6ee0ee70d434d5ea96dbfc60202672417d.yml
+openapi_spec_hash: 9cd5bd74222a21612086b1ca0ad6725d
 config_hash: e17d82e9cb35004e5f9a9d3c4cf51aeb

src/parallel/_client.py

@@ -247,8 +247,10 @@ def extract(
         """
         Extracts relevant content from specific web URLs.
 
-        The legacy Extract API reference is available
-        [here](https://docs.parallel.ai/api-reference/legacy/extract-beta/extract).
+        The legacy Extract API reference (`/v1beta/extract` endpoint) is available
+        [here](https://docs.parallel.ai/api-reference/legacy/extract-beta/extract), and
+        migration guide is
+        [here](https://docs.parallel.ai/extract/extract-migration-guide).
 
         Args:
           urls: URLs to extract content from. Up to 20 URLs.
@@ -322,8 +324,10 @@ def search(
         """
         Searches the web.
 
-        The legacy Search API reference is available
-        [here](https://docs.parallel.ai/api-reference/legacy/search-beta/search).
+        The legacy Search API reference (`/v1beta/search` endpoint) is available
+        [here](https://docs.parallel.ai/api-reference/legacy/search-beta/search), and
+        migration guide is
+        [here](https://docs.parallel.ai/search/search-migration-guide).
 
         Args:
           search_queries: Concise keyword search queries, 3-6 words each. At least one query is required,
@@ -594,8 +598,10 @@ async def extract(
         """
         Extracts relevant content from specific web URLs.
 
-        The legacy Extract API reference is available
-        [here](https://docs.parallel.ai/api-reference/legacy/extract-beta/extract).
+        The legacy Extract API reference (`/v1beta/extract` endpoint) is available
+        [here](https://docs.parallel.ai/api-reference/legacy/extract-beta/extract), and
+        migration guide is
+        [here](https://docs.parallel.ai/extract/extract-migration-guide).
 
         Args:
           urls: URLs to extract content from. Up to 20 URLs.
@@ -669,8 +675,10 @@ async def search(
         """
         Searches the web.
 
-        The legacy Search API reference is available
-        [here](https://docs.parallel.ai/api-reference/legacy/search-beta/search).
+        The legacy Search API reference (`/v1beta/search` endpoint) is available
+        [here](https://docs.parallel.ai/api-reference/legacy/search-beta/search), and
+        migration guide is
+        [here](https://docs.parallel.ai/search/search-migration-guide).
 
         Args:
           search_queries: Concise keyword search queries, 3-6 words each. At least one query is required,