From 51f4fe90cd7432399f3e62b948fbf94a00cfce35 Mon Sep 17 00:00:00 2001
From: rahul kumar <rahul@akto.io>
Date: Tue, 24 Feb 2026 10:09:27 +0530
Subject: [PATCH] feat: add Akto guardrails integration documentation

Add documentation page for Akto Agentic Security guardrails integration,
including setup instructions, guardrail check details, and SDK examples.
Register the page in docs.json navigation and add redirect entry.
---
 docs.json                        |   5 ++
 integrations/guardrails/akto.mdx | 119 +++++++++++++++++++++++++++++++
 2 files changed, 124 insertions(+)
 create mode 100644 integrations/guardrails/akto.mdx

diff --git a/docs.json b/docs.json
index 3a03d099..649f2f31 100644
--- a/docs.json
+++ b/docs.json
@@ -464,6 +464,7 @@
                 "pages": [
                   "integrations/guardrails/aporia",
                   "integrations/guardrails/acuvity",
+                  "integrations/guardrails/akto",
                   "integrations/guardrails/azure-guardrails",
                   "integrations/guardrails/bedrock-guardrails",
                   "integrations/guardrails/crowdstrike-aidr",
@@ -3683,6 +3684,10 @@
       "source": "/product/guardrails/acuvity",
       "destination": "/integrations/guardrails/acuvity"
     },
+    {
+      "source": "/product/guardrails/akto",
+      "destination": "/integrations/guardrails/akto"
+    },
     {
       "source": "/product/guardrails/azure-guardrails",
       "destination": "/integrations/guardrails/azure-guardrails"
diff --git a/integrations/guardrails/akto.mdx b/integrations/guardrails/akto.mdx
new file mode 100644
index 00000000..83f1c1ca
--- /dev/null
+++ b/integrations/guardrails/akto.mdx
@@ -0,0 +1,119 @@
+---
+title: "Akto"
+description: "Akto Agentic Security provides advanced threat detection and security scanning for your LLM inputs and outputs."
+---
+
+[Akto](https://www.akto.io) provides advanced threat detection and security scanning for your AI applications, protecting against prompt injection, sensitive data leakage, and other LLM security threats.
+
+To get started with Akto, visit their website:
+<Card title="Get Started with Akto" href="https://www.akto.io" />
+
+## Using Akto with Portkey
+
+### 1. Add Akto Credentials to Portkey
+
+* Click on the `Admin Settings` button on Sidebar
+* Navigate to `Plugins` tab under Organisation Settings
+* Click on the edit button for the Akto integration
+* Add your Akto API Key and API Domain (obtain these from your Akto account)
+
+### 2. Add Akto's Guardrail Check
+
+* Navigate to the `Guardrails` page and click the `Create` button
+* Search for "Akto Guardrail" and click `Add`
+* Set any `actions` you want on your check, and create the Guardrail!
+
+<Note>
+    Guardrail Actions allow you to orchestrate your guardrails logic. You can learn more about them [here](/product/guardrails#there-are-6-types-of-guardrail-actions)
+</Note>
+
+| Check Name | Description | Parameters | Supported Hooks |
+|------------|-------------|------------|-----------------|
+| Akto Guardrail | Scans and validates LLM inputs and outputs for security threats | None | `beforeRequestHook`, `afterRequestHook` |
+
+### 3. Add Guardrail ID to a Config and Make Your Request
+
+* When you save a Guardrail, you'll get an associated Guardrail ID - add this ID to the `before_request_hooks` or `after_request_hooks` params in your Portkey Config
+* Create these Configs in Portkey UI, save them, and get an associated Config ID to attach to your requests. [More here](/product/ai-gateway/configs).
+
+Here's an example configuration:
+
+```json
+{
+  "input_guardrails": ["guardrails-id-xxx"],
+  "output_guardrails": ["guardrails-id-yyy"],
+}
+```
+
+<Tabs>
+  <Tab title="NodeJS">
+
+```js
+const portkey = new Portkey({
+    apiKey: "PORTKEY_API_KEY",
+    config: "pc-***" // Supports a string config id or a config object
+});
+```
+  </Tab>
+  <Tab title="Python">
+
+```py
+portkey = Portkey(
+    api_key="PORTKEY_API_KEY",
+    config="pc-***" # Supports a string config id or a config object
+)
+```
+  </Tab>
+  <Tab title="OpenAI NodeJS">
+
+```js
+const openai = new OpenAI({
+  apiKey: 'OPENAI_API_KEY',
+  baseURL: PORTKEY_GATEWAY_URL,
+  defaultHeaders: createHeaders({
+    apiKey: "PORTKEY_API_KEY",
+    config: "CONFIG_ID"
+  })
+});
+```
+  </Tab>
+  <Tab title="OpenAI Python">
+
+```py
+client = OpenAI(
+    api_key="OPENAI_API_KEY", # defaults to os.environ.get("OPENAI_API_KEY")
+    base_url=PORTKEY_GATEWAY_URL,
+    default_headers=createHeaders(
+        provider="openai",
+        api_key="PORTKEY_API_KEY", # defaults to os.environ.get("PORTKEY_API_KEY")
+        config="CONFIG_ID"
+    )
+)
+```
+  </Tab>
+<Tab title="cURL">
+
+```sh
+curl https://api.portkey.ai/v1/chat/completions \
+  -H "Content-Type: application/json" \
+  -H "Authorization: Bearer $OPENAI_API_KEY" \
+  -H "x-portkey-api-key: $PORTKEY_API_KEY" \
+  -H "x-portkey-config: $CONFIG_ID" \
+  -d '{
+    "model": "gpt-3.5-turbo",
+    "messages": [{
+        "role": "user",
+        "content": "Hello!"
+      }]
+  }'
+```
+  </Tab>
+</Tabs>
+
+For more, refer to the [Config documentation](/product/ai-gateway/configs).
+
+Your requests are now guarded by Akto's security scanning, and you can see the verdict and any actions taken directly in your Portkey logs!
+
+## Get Support
+
+If you face any issues with the Akto integration, join the [Portkey community forum](https://discord.gg/portkey-llms-in-prod-1143393887742861333) for assistance.