Updating API doc for proxy

Author: dannyroosevelt

docs-v2/pages/connect/api-proxy.mdx

@@ -13,11 +13,11 @@ Pipedream Connect provides a proxy API that you can use to send authenticated re
 
 The Connect proxy enables you to interface with any integrated API and make authenticated requests on behalf of your users, without dealing with OAuth or storing end user credentials.
 
-- You send a request to the proxy and identify the end user you want to act on behalf of
-- The proxy sends the request to the downstream API and dynamically inserts your end user's auth credentials
-- The proxy returns the response from the downstream API back to you
+1. You send a request to the proxy and identify the end user you want to act on behalf of
+2. The proxy sends the request to the downstream API and dynamically inserts your end user's auth credentials
+3. The proxy returns the response from the downstream API back to you
 
-![Connect API proxy visualization](https://res.cloudinary.com/pipedreamin/image/upload/v1738734958/pd-connect-proxy-viz_y8fzuk.png)
+![Connect API proxy visualization](https://res.cloudinary.com/pipedreamin/image/upload/v1738822030/pd-connect-proxy-viz_k5iksb.png)
 
 <Callout type="info">
 Before getting started with the Connect proxy, make sure you've already gone through the [managed auth quickstart](/connect/managed-auth/quickstart) for Pipedream Connect.
@@ -28,33 +28,16 @@ Before getting started with the Connect proxy, make sure you've already gone thr
 You can send requests to the Connect proxy using the [Pipedream SDK](/connect/sdk) with a fetch-style interface, or by making a request to the [REST API](/rest-api/connect/proxy).
 
 - A [Pipedream OAuth client](/rest-api/auth#oauth) to make authenticated requests to Pipedream's API
-- The [external user ID](/connect/api#external-users) for your end user (ex, `abc-123`)
 - Connect [environment](/connect/environments) (ex, `production` or `development`)
+- The [external user ID](/connect/api#external-users) for your end user (ex, `abc-123`)
 - The [account ID](/connect/api#accounts) for your end user's connected account (ex, `apn_1234567`)
 
-### Code examples
-
-**URL**
-
-- The URL of the API you want to call (ex, `https://slack.com/api/chat.postMessage`)
-- If using the REST API, this should be an URL-safe Base64 encoded string (ex, `aHR0cHM6Ly9zbGFjay5jb20vYXBpL2NoYXQucG9zdE1lc3NhZ2U`)
+Refer to the full Connect API [here](/connect/api).
 
-**HTTP method**
+### Using the Pipedream SDK (preferred)
 
-- Use the HTTP method required by the downstream API
-
-**Body**
+You can use the [Pipedream SDK](https://www.npmjs.com/package/@pipedream/sdk) to send a fetch-style request:
 
-- Optionally include a body to send to the downstream API
-
-**Headers**
-
-- If using the REST API, include the `Authorization` header with your Pipedream OAuth access token (`Bearer {access_token}`)
-- Only headers that contain the prefix `x-pd-proxy` will get forwarded to the downstream API
-
-<Tabs items={['Node.js', 'HTTP (cURL)']}>
-
-<Tabs.Tab>
 ```javascript
 import { createBackendClient } from "@pipedream/sdk/server";
 
@@ -67,29 +50,55 @@ const pd = createBackendClient({
   },
 });
 
-const url = "https://slack.com/api/chat.postMessage" // No need to Base64 encode the URL if using the SDK
-const params = {
-  account_id: "{account_id}", // The account ID for your end user (ex, apn_1234567)
-  external_user_id: "{external_user_id}", // The external user ID for your end user
-}
 
 const resp = await pd.makeProxyRequest(
-  url,
-  params,
   {
-  method: "POST",
-  body: {
-    text: "hello, world",
-    channel: "C03NA8B4VA9"
+    searchParams: {
+      account_id: "{account_id}", // The account ID for your end user (ex, apn_1234567)
+      external_user_id: "{external_user_id}", // The external user ID for your end user
+    }
   },
-})
+  {
+    url: "https://slack.com/api/chat.postMessage", // Include any query params you need; no need to Base64 encode the URL if using the SDK
+    options: {
+      method: "POST",
+      headers: {
+        hello: "world!" // These get sent to the downstream API
+      },
+      body: {
+        text: "hello, world",
+        channel: "C03NA8B4VA9"
+      },
+    },
+  }
+)
 
 // Parse and return the data you need
 console.log(resp);
 ```
-</Tabs.Tab>
 
-<Tabs.Tab>
+### Using the REST API
+
+You can also send a request to the Connect REST API with the below config:
+
+**URL**
+
+- The URL of the API you want to call (ex, `https://slack.com/api/chat.postMessage`)
+- When using the REST API, this should be an URL-safe Base64 encoded string (ex, `aHR0cHM6Ly9zbGFjay5jb20vYXBpL2NoYXQucG9zdE1lc3NhZ2U`)
+
+**HTTP method**
+
+- Use the HTTP method required by the downstream API
+
+**Body**
+
+- Optionally include a body to send to the downstream API
+
+**Headers**
+
+- If using the REST API, include the `Authorization` header with your Pipedream OAuth access token (`Bearer {access_token}`)
+- Headers that contain the prefix `x-pd-proxy` will get forwarded to the downstream API
+
 ```bash
 # First, obtain an OAuth access token
 curl -X POST https://api.pipedream.com/v1/oauth/token \
@@ -111,7 +120,4 @@ curl -X POST "https://api.pipedream.com/v1/connect/{your_project_id}/proxy/{url_
   }'
 
 # Parse and return the data you need
-```
-</Tabs.Tab>
-
-</Tabs>
+```