Merge branch 'main' into chore/update-crewai-docs

Author: siddharthsambharia-portkey

api-reference/inference-api/authentication.mdx

@@ -14,6 +14,10 @@ To ensure secure access to Portkey's APIs, authentication is required for all re
 
 Based on your access level, you might see the relevant permissions on the API key modal - tick the ones you'd like, name your API key, and save it.
 
+<Card title="JWT-based Authentication" href="#jwt-based-authentication">
+    You can also authenticate Portkey using JWT Tokens. Learn more here
+</Card>
+
 ## Authentication with SDKs
 
 ### Portkey SDKs
@@ -130,3 +134,25 @@ response = openai_client.chat.completions.create(
 </Tabs>
 
 Read more [here](/integrations/llms/openai).
+
+
+## JWT-based Authentication
+
+Portkey supports JWT-based authentication as a secure alternative to API Key authentication. With JWT authentication, clients can authenticate API requests using a JWT token that is validated against a configured JWKS (JSON Web Key Set).
+
+This enterprise-grade authentication method is available as an add-on to any Portkey plan. JWT authentication provides enhanced security through:
+
+- Temporary, expiring tokens
+- Fine-grained permission scopes
+- User identity tracking
+- Centralized authentication management
+
+<Card title="JWT Token Authentication" href="/product/enterprise-offering/org-management/jwt">
+    Learn how to implement JWT-based authentication with Portkey
+</Card>
+
+<Note>
+    <b>Interested in adding JWT authentication to your Portkey plan?</b>
+    
+    [Contact our sales team](https://portkey.sh/jwt) to discuss pricing and implementation details.
+</Note>

api-reference/inference-api/gateway-for-other-apis.mdx

@@ -11,7 +11,18 @@ Portkey API has first-class support for monitoring and routing your requests to
 
 **However**, there are still many endpoints like Cohere's `/rerank` or Deepgram's `/listen` that are uncommon or have niche use cases.
 
-With the **Gateway to Other APIs** feature, you can route to any custom provider endpoint using Portkey (including the ones hosted on your private setups) and get **complete logging  & monitoring** for all your requests.
+With the **Gateway to Other APIs** feature, you can route to any custom provider endpoint using Portkey (including the ones hosted on your private setups) and get **complete logging & monitoring** for all your requests.
+
+## Supported HTTP Methods
+
+<CardGroup cols={4}>
+  <Card title="POST" color="#4CAF50" />
+  <Card title="GET" color="#2196F3" />
+  <Card title="PUT" color="#FF9800" />
+  <Card title="DELETE" color="#F44336" />
+</CardGroup>
+
+Both the REST API and Portkey SDKs (Python, NodeJS) support all of these HTTP methods.
 
 # How to Integrate
 
@@ -21,7 +32,7 @@ With the **Gateway to Other APIs** feature, you can route to any custom provider
 
 
 ## 1. Get Portkey API Key
-Create or log in to your Portkey account. Grab your account’s API key from the [“API Keys” page](https://app.portkey.ai/api-keys).
+Create or log in to your Portkey account. Grab your account's API key from the ["API Keys" page](https://app.portkey.ai/api-keys).
 
 ## 2. Add Provider Details
 
@@ -148,7 +159,8 @@ Construct your request URL:
 1. Portkey Gateway base URL remains same: `https://api.portkey.ai/v1`
 2. Append your custom endpoint at the end of the URL: `https://api.portkey.ai/v1/{provider-endpoint}`
 
-```bash
+<CodeGroup>
+```bash POST
 curl --request POST \
      --url https://api.portkey.ai/v1/rerank \
      --header 'Content-Type: application/json' \
@@ -163,14 +175,43 @@ curl --request POST \
        ]
      }'
 ```
+
+```bash GET
+curl --request GET \
+     --url https://api.portkey.ai/v1/collections \
+     --header 'Content-Type: application/json' \
+     --header 'x-portkey-api-key: $PORTKEY_API_KEY' \
+     --header 'x-portkey-virtual-key: $PROVIDER_VIRTUAL_KEY'
+```
+
+```bash PUT
+curl --request PUT \
+     --url https://api.portkey.ai/v1/collections/my-collection \
+     --header 'Content-Type: application/json' \
+     --header 'x-portkey-api-key: $PORTKEY_API_KEY' \
+     --header 'x-portkey-virtual-key: $PROVIDER_VIRTUAL_KEY' \
+     --data '{
+       "metadata": {
+         "description": "Updated collection description"
+       }
+     }'
+```
+
+```bash DELETE
+curl --request DELETE \
+     --url https://api.portkey.ai/v1/collections/my-collection \
+     --header 'Content-Type: application/json' \
+     --header 'x-portkey-api-key: $PORTKEY_API_KEY' \
+     --header 'x-portkey-virtual-key: $PROVIDER_VIRTUAL_KEY'
+```
+</CodeGroup>
 </Tab>
 
 <Tab title="Python SDK">
-<Info>The SDK supports the `POST` method currently.</Info>
-1. Instantiate your Portkey client
-2. Use the `.post(url, requestParams)` method to make requests:
+The SDK fully supports all HTTP methods: `POST`, `GET`, `PUT`, and `DELETE`.
 
-```python
+<CodeGroup>
+```python POST
 from portkey_ai import Portkey
 
 portkey = Portkey(
@@ -188,14 +229,52 @@ response = portkey.post(
     ]
 )
 ```
+
+```python GET
+from portkey_ai import Portkey
+
+portkey = Portkey(
+    api_key="PORTKEY_API_KEY",
+    virtual_key="PROVIDER_VIRTUAL_KEY"
+)
+
+response = portkey.get('/collections')
+```
+
+```python PUT
+from portkey_ai import Portkey
+
+portkey = Portkey(
+    api_key="PORTKEY_API_KEY",
+    virtual_key="PROVIDER_VIRTUAL_KEY"
+)
+
+response = portkey.put(
+    '/collections/my-collection',
+    metadata={
+        "description": "Updated collection description"
+    }
+)
+```
+
+```python DELETE
+from portkey_ai import Portkey
+
+portkey = Portkey(
+    api_key="PORTKEY_API_KEY",
+    virtual_key="PROVIDER_VIRTUAL_KEY"
+)
+
+response = portkey.delete('/collections/my-collection')
+```
+</CodeGroup>
 </Tab>
 
 <Tab title="NodeJS SDK">
-<Info>The SDK supports the `POST` method currently.</Info>
-1. Instantiate your Portkey client
-2. Use the `.post(url, requestParams)` method to make requests:
+The SDK fully supports all HTTP methods: `POST`, `GET`, `PUT`, and `DELETE`.
 
-```javascript
+<CodeGroup>
+```javascript POST
 import Portkey from 'portkey-ai';
 
 const portkey = new Portkey({
@@ -212,6 +291,44 @@ const response = await portkey.post('/rerank', {
     ]
 });
 ```
+
+```javascript GET
+import Portkey from 'portkey-ai';
+
+const portkey = new Portkey({
+    apiKey: "PORTKEY_API_KEY",
+    virtualKey: "PROVIDER_VIRTUAL_KEY"
+});
+
+const response = await portkey.get('/collections');
+```
+
+```javascript PUT
+import Portkey from 'portkey-ai';
+
+const portkey = new Portkey({
+    apiKey: "PORTKEY_API_KEY",
+    virtualKey: "PROVIDER_VIRTUAL_KEY"
+});
+
+const response = await portkey.put('/collections/my-collection', {
+    metadata: {
+        description: "Updated collection description"
+    }
+});
+```
+
+```javascript DELETE
+import Portkey from 'portkey-ai';
+
+const portkey = new Portkey({
+    apiKey: "PORTKEY_API_KEY",
+    virtualKey: "PROVIDER_VIRTUAL_KEY"
+});
+
+const response = await portkey.delete('/collections/my-collection');
+```
+</CodeGroup>
 </Tab>
 </Tabs>
 
@@ -247,8 +364,8 @@ response = portkey.post(
 # Caveats & Considerations
 
 - Response objects are returned exactly as received from the provider, without Portkey transformations
-- REST API supports all HTTP methods
-- SDK currently supports `POST` only (more methods coming soon)
+- REST API supports all HTTP methods: `POST`, `GET`, `PUT`, and `DELETE`
+- SDK supports all HTTP methods: `POST`, `GET`, `PUT`, and `DELETE`
 - There are no limitations on which provider endpoints can be proxied
 - All requests are logged and monitored through your Portkey dashboard
 

docs.json

@@ -101,20 +101,9 @@
                 "pages": [
                   "product/guardrails",
                   "product/guardrails/list-of-guardrail-checks",
-                  "product/guardrails/azure-guardrails",
-                  "product/guardrails/pii-redaction",
-                  "product/guardrails/patronus-ai",
-                  "product/guardrails/bedrock-guardrails",
-                  "product/guardrails/lasso",
-                  "product/guardrails/aporia",
-                  "product/guardrails/pillar",
-                  "product/guardrails/prompt-security",
-                  "product/guardrails/pangea",
-                  "product/guardrails/acuvity",
-                  "product/guardrails/mistral",
                   "product/guardrails/embedding-guardrails",
-                  "product/guardrails/bring-your-own-guardrails",
-                  "product/guardrails/creating-raw-guardrails-in-json"
+                  "product/guardrails/creating-raw-guardrails-in-json",
+                  "product/guardrails/pii-redaction"
                 ]
               },
               "product/mcp",
@@ -333,6 +322,22 @@
             "group": "Cloud Platforms",
             "pages": ["integrations/cloud/azure"]
           },
+          {
+            "group": "Guardrails",
+            "pages": [
+              "integrations/guardrails/aporia",
+              "integrations/guardrails/acuvity",
+              "integrations/guardrails/azure-guardrails",
+              "integrations/guardrails/bedrock-guardrails",
+              "integrations/guardrails/lasso",
+              "integrations/guardrails/mistral",
+              "integrations/guardrails/pangea",
+              "integrations/guardrails/patronus-ai",
+              "integrations/guardrails/pillar",
+              "integrations/guardrails/prompt-security",
+              "integrations/guardrails/bring-your-own-guardrails"
+            ]
+          },
           {
             "group": "Plugins",
             "pages": ["integrations/plugins/exa"]
@@ -869,7 +874,10 @@
           },
           {
             "group": "SDK Releases",
-            "pages": ["changelog/node-sdk-changelog", "changelog/python-sdk-changelog"]
+            "pages": [
+              "changelog/node-sdk-changelog",
+              "changelog/python-sdk-changelog"
+            ]
           }
         ]
       }
@@ -2241,6 +2249,50 @@
     {
       "source": "/api-reference/inference-api/sdks/c-sharp",
       "destination": "/api-reference/sdk/c-sharp"
+    },
+    {
+      "source": "/product/guardrails/aporia",
+      "destination": "/integrations/guardrails/aporia"
+    },
+    {
+      "source": "/product/guardrails/acuvity",
+      "destination": "/integrations/guardrails/acuvity"
+    },
+    {
+      "source": "/product/guardrails/azure-guardrails",
+      "destination": "/integrations/guardrails/azure-guardrails"
+    },
+    {
+      "source": "/product/guardrails/bedrock-guardrails",
+      "destination": "/integrations/guardrails/bedrock-guardrails"
+    },
+    {
+      "source": "/product/guardrails/lasso",
+      "destination": "/integrations/guardrails/lasso"
+    },
+    {
+      "source": "/product/guardrails/mistral",
+      "destination": "/integrations/guardrails/mistral"
+    },
+    {
+      "source": "/product/guardrails/pangea",
+      "destination": "/integrations/guardrails/pangea"
+    },
+    {
+      "source": "/product/guardrails/patronus-ai",
+      "destination": "/integrations/guardrails/patronus-ai"
+    },
+    {
+      "source": "/product/guardrails/pillar",
+      "destination": "/integrations/guardrails/pillar"
+    },
+    {
+      "source": "/product/guardrails/prompt-security",
+      "destination": "/integrations/guardrails/prompt-security"
+    },
+    {
+      "source": "/product/guardrails/bring-your-own-guardrails",
+      "destination": "/integrations/guardrails/bring-your-own-guardrails"
     }
   ],
   "seo": {