httpx client for python

Author: vrushankportkey

api-reference/sdk/python.mdx

@@ -101,8 +101,38 @@ async def main():
 asyncio.run(main())
 ```
 
+## Using a Custom httpx Client
 
-### Adding Trace ID or Metadata
+If you need to customize HTTP networking—for example, to disable SSL verification due to VPNs like Zscaler or to use custom proxies—you can pass your own `httpx.Client` to the Portkey SDK.
+
+<Warning>Disabling SSL certificate verification is insecure and should only be used for debugging or in trusted internal environments. Never use this in production.</Warning>
+
+**Example: Disable SSL Verification**
+```python
+import httpx
+from portkey_ai import Portkey
+
+# Create an httpx client with SSL verification disabled
+custom_client = httpx.Client(verify=False)
+
+portkey = Portkey(
+    api_key="your_api_key_here",
+    virtual_key="your_virtual_key_here",
+    http_client=custom_client
+)
+
+response = portkey.chat.completions.create(
+    messages=[{"role": "user", "content": "Hello!"}],
+    model="gpt-4o"
+)
+print(response)
+```
+
+- You can use any `httpx.Client` options (e.g., for proxies, timeouts, custom headers).
+- For async usage, pass an `httpx.AsyncClient` to `AsyncPortkey`.
+- See [OpenAI Python SDK: Configuring the HTTP client](https://github.com/openai/openai-python#configuring-the-http-client) for more examples and best practices.
+
+## Adding Trace ID or Metadata
 
 You can choose to override the configuration in individual requests as well and send trace id or metadata along with each request.
 
@@ -156,6 +186,9 @@ completion = portkey.with_options(
 <Accordion title="Can I use this SDK with OpenAI-compatible code?">
 Yes! Portkey’s Python SDK is OpenAI-compatible. You can also use any OpenAI-compatible library by pointing it to the Portkey API endpoint and using your Portkey API key.
 </Accordion>
+<Accordion title="How do I fix CERTIFICATE_VERIFY_FAILED or SSL errors?">
+If you are behind a VPN (like Zscaler) or a corporate proxy and see SSL/certificate errors, you can pass a custom `httpx.Client` to the Portkey SDK with SSL verification disabled. See the docs above for an example. **Warning:** Disabling SSL verification is insecure—only use this as a last resort or for debugging.
+</Accordion>
 <Accordion title="Where can I find more examples?">
 Check out our integration docs [here](/integrations/ecosystem).
 </Accordion>