Revert back to original API behavior for default API URLs, server_url need and placement (#490)

Co-authored-by: Austin Walker <[email protected]>

Author: Paul-Cornell

api-reference/api-services/examples.mdx

@@ -11,19 +11,6 @@ import SharedAPIKeyURL from '/snippets/general-shared-text/api-key-url.mdx';
 
 import NoURLForServerlessAPI from '/snippets/general-shared-text/no-url-for-serverless-api.mdx';
 
-<Warning>
-    **Important**: Beginning with Python SDK 0.30.0, note the following:
-    
-    - For the Unstructured Serverless API URL, do not use `https://api.unstructuredapp.io/general/v0/general`, or else calls made by 
-      the Python SDK will fail. Use `https://api.unstructuredapp.io` instead.    
-    - For the Free Unstructured API URL, do not use `https://api.unstructured.io/general/v0/general`, or else calls made by 
-      the Python SDK will fail. Use `https://api.unstructured.io` instead. 
-    - If your Python code previously used the `server_url` parameter inside of your `UnstructuredClient` constructor to specify your Unstructured API URL, you must move this `server_url` parameter into 
-      your code's `partition` or `partition_async` function calls instead, or else calls made by the Python SDK will fail. To learn how, see the following code examples.
-
-    [Learn more](/api-reference/api-services/sdk-python#migration-guide).
-</Warning>
-
 <NoURLForServerlessAPI/>
 
 import UseIngestOrPlatformInstead from '/snippets/general-shared-text/use-ingest-or-platform-instead.mdx';
@@ -136,8 +123,7 @@ The `hi_res` strategy supports different models, and the default is `layout_v1.1
 
             try:
                 res = await client.general.partition_async(
-                    request=req,
-                    server_url=os.getenv("UNSTRUCTURED_API_URL")
+                    request=req
                 )
                 element_dicts = [element for element in res.elements]
                 json_elements = json.dumps(element_dicts, indent=2)
@@ -356,8 +342,7 @@ For better OCR results, you can specify what languages your document is in using
 
             try:
                 res = await client.general.partition_async(
-                    request=req, 
-                    server_url=os.getenv("UNSTRUCTURED_API_URL")
+                    request=req
                 )
                 element_dicts = [element for element in res.elements]
                 json_elements = json.dumps(element_dicts, indent=2)
@@ -573,8 +558,7 @@ Set the `coordinates` parameter to `true` to add this field to the elements in t
 
             try:
                 res = await client.general.partition_async(
-                    request=req,
-                    server_url=os.getenv("UNSTRUCTURED_API_URL")
+                    request=req
                 )
                 element_dicts = [element for element in res.elements]
                 json_elements = json.dumps(element_dicts, indent=2)
@@ -793,8 +777,7 @@ This can be helpful if you'd like to use the IDs as a primary key in a database,
 
             try:
                 res = await client.general.partition_async(
-                    request=req,
-                    server_url=os.getenv("UNSTRUCTURED_API_URL")
+                    request=req
                 )
                 element_dicts = [element for element in res.elements]
                 json_elements = json.dumps(element_dicts, indent=2)
@@ -1020,8 +1003,7 @@ By default, the `chunking_strategy` is set to `None`, and no chunking is perform
 
             try:
                 res = await client.general.partition_async(
-                    request=req,
-                    server_url=os.getenv("UNSTRUCTURED_API_URL")
+                    request=req
                 )
                 element_dicts = [element for element in res.elements]
                 json_elements = json.dumps(element_dicts, indent=2)

api-reference/api-services/free-api.mdx

@@ -19,17 +19,6 @@ The Free Unstructured API requires authentication via an API key. Here's how you
 5.  Click **Submit**. You will receive a Free Unstructured API key at the **Email** you provided. Store your API key in a secure location. Do not share it with others.
 6.  For the Free Unstructured API, the API URL is `https://api.unstructured.io/general/v0/general`
 
-<Warning>
-    **Important**: This article shows how to use Free Unstructured API with the Unstructured CLI and the 
-    Unstructured Ingest Python library. While you can also use this API URL with the Unstructured Python SDK, 
-    beginning with Python SDK 0.30.0, note the following:
-    
-    - Do not use https://api.unstructured.io/general/v0/general, or else calls made by 
-      the Python SDK will fail. Use https://api.unstructured.io` instead.    
-    - If your Python code uses the `server_url` parameter inside of your `UnstructuredClient` constructor to specify this URL, you must move this `server_url` parameter into 
-      your code's `partition` or `partition_async` function calls instead, or else calls made by the Python SDK will fail.
-</Warning>
-
 import FreeKeyNoServerlessURL from '/snippets/general-shared-text/free-api-key-no-serverless-access.mdx';
 
 <FreeKeyNoServerlessURL />

api-reference/api-services/saas-api-development-guide.mdx

@@ -13,7 +13,7 @@ This page describes how to get started with the Unstructured Serverless API. Lea
 
 ## Get started
 
-To call the Unstructured Serverless API, you need an Unstructured account, API key, and API URL:
+To call the Unstructured Serverless API, you need an Unstructured account and an Unstructured API key:
 
 <Steps>
     <Step title="Sign up">
@@ -64,7 +64,7 @@ To call the Unstructured Serverless API, you need an Unstructured account, API k
         </Tip>
 
     </Step> 
-    <Step title="Get your API key and API URL">
+    <Step title="Get your API key">
 
         <img src="https://unstructured-tech-docs.s3.amazonaws.com/Unstructured-Platform-APIKeyURL.gif" alt="Unstructured API key how-to" width="500" />
 
@@ -76,27 +76,9 @@ To call the Unstructured Serverless API, you need an Unstructured account, API k
         2. On the **API Keys** tab, click **Generate New Key**.
         3. Enter some descriptive name for the API key, and then click **Save**.
         4. Click the **Copy** icon for your new API key. The API key's value is copied to your system's clipboard.
-        5. Note the Unstructured **Serverless API URL**, which is `https://api.unstructuredapp.io/general/v0/general`
-
-        ![Unstructured Serverless API URL](/img/platform/ServerlessAPIURL.png)
-
-        <Warning>
-            Do not use the Unstructured **Platform API URL**, which is separate from the Unstructured Serverless API URL.
-        </Warning>
-
-        <Note>
-            If you signed up through the [For Enterprise](https://unstructured.io/enterprise) page, your API URL 
-            might be different. For API URL guidance, email Unstructured Sales at [[email protected]](mailto:[email protected]). 
-            If your API URL is different, be sure to substitute `https://api.unstructuredapp.io/general/v0/general` for your 
-            API URL throughout the following examples.
-        </Note>    
     </Step>
 </Steps>
 
-import ServerlessKeyNoFreeURL from '/snippets/general-shared-text/serverless-api-key-no-free-access.mdx';
-
-<ServerlessKeyNoFreeURL />
-
 [Try the quickstart](#quickstart).
 
 ## Set up billing
@@ -137,6 +119,10 @@ import SharedPagesBilling from '/snippets/general-shared-text/pages-billing.mdx'
 
 These examples use your local machine. They send source (input) files from your local machine to the Unstructured Serverless API which delivers the processed data to a destination (output) location, also on your local machine. Data is processed on Unstructured-hosted compute resources.
 
+import NoURLForServerlessAPI from '/snippets/general-shared-text/no-url-for-serverless-api.mdx';
+
+<NoURLForServerlessAPI/>
+
 ### Unstructured Ingest CLI
 
 To work with the Unstructured Serverless API by using the [Unstructured Ingest CLI](/ingestion/overview#unstructured-ingest-cli), you will need to:
@@ -147,12 +133,11 @@ To work with the Unstructured Serverless API by using the [Unstructured Ingest C
   pip install unstructured-ingest
   ```
 
-- Set the following environment variables:
+- Set the following environment variable:
 
   - Set `UNSTRUCTURED_API_KEY` to your API key.
-  - Set `UNSTRUCTURED_API_URL` to your API URL.
 
-  [Get your API key and API URL](#get-started).
+  [Get your API key](#get-started).
 
 - Have some compatible files on your local machine to be processed. [See the list of supported file types](/api-reference/api-services/supported-file-types). If you do not have any files available, you can download some from the [example-docs](https://github.com/Unstructured-IO/unstructured-ingest/tree/main/example-docs) folder in the Unstructured repo on GitHub.
 
@@ -168,7 +153,6 @@ unstructured-ingest \
     --output-dir <path/to/output> \
     --partition-by-api \
     --api-key $UNSTRUCTURED_API_KEY \
-    --partition-endpoint $UNSTRUCTURED_API_URL \
     --strategy hi_res \
     --additional-partition-args="{\"split_pdf_page\":\"true\", \"split_pdf_allow_failed\":\"true\", \"split_pdf_concurrency_level\": 15}"
 ```
@@ -188,9 +172,8 @@ To work with the Unstructured Serverless API by using the [Unstructured Python l
 - Set the following environment variables:
 
   - Set `UNSTRUCTURED_API_KEY` to your API key.
-  - Set `UNSTRUCTURED_API_URL` to your API URL.
 
-  [Get your API key and API URL](#get-started).
+  [Get your API key](#get-started).
 
 - Have some compatible files on your local machine to be processed. [See the list of supported file types](/api-reference/api-services/supported-file-types). If you do not have any files available, you can download some from the [example-docs](https://github.com/Unstructured-IO/unstructured-ingest/tree/main/example-docs) folder in the Unstructured repo on GitHub.
 

api-reference/api-services/sdk-python.mdx

@@ -18,19 +18,6 @@ import SharedAPIKeyURL from '/snippets/general-shared-text/api-key-url.mdx';
 
 <SharedAPIKeyURL />
 
-<Warning>
-    **Important**: Beginning with Python SDK 0.30.0, note the following:
-    
-    - For the Unstructured Serverless API URL, do not use `https://api.unstructuredapp.io/general/v0/general`, or else calls made by 
-      the Python SDK will fail. Use `https://api.unstructuredapp.io` instead.    
-    - For the Free Unstructured API URL, do not use `https://api.unstructured.io/general/v0/general`, or else calls made by 
-      the Python SDK will fail. Use `https://api.unstructured.io` instead. 
-    - If your Python code previously used the `server_url` parameter inside of your `UnstructuredClient` constructor to specify your Unstructured API URL, you must move this `server_url` parameter into 
-      your code's `partition` or `partition_async` function calls instead, or else calls made by the Python SDK will fail. To learn how, see the following code examples.
-
-    [Learn more](#migration-guide).
-</Warning>
-
 import NoURLForServerlessAPI from '/snippets/general-shared-text/no-url-for-serverless-api.mdx';
 
 <NoURLForServerlessAPI/>
@@ -80,8 +67,7 @@ import NoURLForServerlessAPI from '/snippets/general-shared-text/no-url-for-serv
 
     try:
         res = client.general.partition(
-            request=req,
-            server_url=os.getenv("UNSTRUCTURED_API_URL")
+            request=req
         )
         element_dicts = [element for element in res.elements]
 
@@ -124,8 +110,7 @@ import NoURLForServerlessAPI from '/snippets/general-shared-text/no-url-for-serv
 
     try:
         res = client.general.partition(
-            request=req,
-            server_url=os.getenv("UNSTRUCTURED_API_URL")
+            request=req
         )
         element_dicts = [element for element in res.elements]
 
@@ -171,8 +156,7 @@ import NoURLForServerlessAPI from '/snippets/general-shared-text/no-url-for-serv
 
         try:
             res = await client.general.partition_async(
-                request=req,
-                server_url=os.getenv("UNSTRUCTURED_API_URL")
+                request=req
             )
             element_dicts = [element for element in res.elements]
             json_elements = json.dumps(element_dicts, indent=2)
@@ -246,8 +230,7 @@ import NoURLForServerlessAPI from '/snippets/general-shared-text/no-url-for-serv
         )
     )
     res = client.general.partition(
-        request=req,
-        server_url=os.getenv("UNSTRUCTURED_API_URL")
+        request=req
     )
     ```
 
@@ -263,8 +246,7 @@ import NoURLForServerlessAPI from '/snippets/general-shared-text/no-url-for-serv
         import os 
 
         client = UnstructuredClient(
-            api_key_auth=os.getenv("UNSTRUCTURED_API_KEY"),
-            server_url=os.getenv("UNSTRUCTURED_API_URL"),
+            api_key_auth=os.getenv("UNSTRUCTURED_API_KEY")
             retry_config=RetryConfig(
                 strategy="backoff",
                 retry_connection_errors=True,
@@ -322,49 +304,7 @@ the names used in the SDKs are the same across all methods.
 
 ## Migration guide
 
-There are breaking changes beginning with Python SDK version 0.26.0 and again in 0.30.0. If you encounter any errors when upgrading, please find the solution below.
-
-**If you see the error: `404 Not Found`**
-
-Before 0.30.0, you could specify the following Unstructured API URL for the `server_url` parameter:
-
-- For the Unstructured Serverless API: `https://api.unstructuredapp.io/general/v0/general`
-- For the Free Unstructured API: `https://api.unstructured.io/general/v0/general`
-
-Beginning with 0.30.0, these Unstructured API URLs have changed as follows:
-
-- For the Unstructured Serverless API: `https://api.unstructuredapp.io` (remove `/general/v0/general`)
-- For the Free Unstructured API: `https://api.unstructured.io` (remove `/general/v0/general`)
-
-Also, before 0.30.0, the `server_url` parameter was part of the `UnstructuredClient` constructor. Beginning with 0.30.0, the `server_url` 
-parameter has been moved into the `partition` and `partition_async` functions.
-
-```python
-# Instead of:
-client = unstructured_client.UnstructuredClient(
-    api_key_auth=os.getenv("UNSTRUCTURED_API_KEY"),
-    server_url=os.getenv("UNSTRUCTURED_API_URL")
-)
-
-# Switch to:
-client = unstructured_client.UnstructuredClient(
-    api_key_auth=os.getenv("UNSTRUCTURED_API_KEY")
-)
-
-# And...
-
-# For partition:
-res = client.general.partition(
-    request=req,
-    server_url=os.getenv("UNSTRUCTURED_API_URL")
-)
-
-# For partition_async:
-res = await client.general.partition_async(
-    request=req,
-    server_url=os.getenv("UNSTRUCTURED_API_URL")
-)
-```
+There are breaking changes beginning with Python SDK version 0.26.0. If you encounter any errors when upgrading, please find the solution below.
 
 **If you see the error: `AttributeError: 'PartitionParameters' object has no attribute 'partition_parameters'`**
 
@@ -379,8 +319,7 @@ req = shared.PartitionParameters(
 )
 
 resp = s.general.partition(
-    request=req,
-    server_url=os.getenv("UNSTRUCTURED_API_URL") # Beginning with 0.30.0
+    request=req
 )
 
 # Switch to:
@@ -393,8 +332,7 @@ req = operations.PartitionRequest(
 )
 
 resp = s.general.partition(
-    request=req,
-    server_url=os.getenv("UNSTRUCTURED_API_URL") # Beginning with 0.30.0
+    request=req
 )
 ```
 
@@ -428,7 +366,6 @@ resp = s.general.partition(req)
 
 # Switch to:
 resp = s.general.partition(
-    request=req,
-    server_url=os.getenv("UNSTRUCTURED_API_URL") # Beginning with 0.30.0
+    request=req
 )
 ```