Skip to main content
Guardrails provide a powerful way to manage and implement content detection and filtering with separate configurations for input (prompt) and output (response) scanning. Unlike the legacy Policy API, guardrails support separate input and output detector configurations in a single entity.

​
Guardrail Management

  1. Add Guardrail
    • Create new guardrails with separate input and output detector configurations.
    • Specify guardrail name, description, and detector settings for each direction.
import requests
import json
import os

url = "https://api.enkryptai.com/guardrails/add-guardrail"

payload = json.dumps({
    "name": "My Guardrail",
    "description": "Production guardrail with input/output scanning",
    "input": {
        "injection_attack": {
            "enabled": True,
            "block_message": "Potential injection attack detected"
        },
        "toxicity": {
            "enabled": True,
            "block_message": "Toxic content detected"
        },
        "pii": {
            "enabled": True,
            "entities": ["pii", "secrets", "ip_address", "url"]
        },
        "keyword_detector": {
            "enabled": True,
            "banned_keywords": ["confidential", "internal-only"]
        },
        "policy_violation": {
            "enabled": True,
            "need_explanation": True,
            "coc_policy_name": "My CoC Policy",
            "block_message": "Policy violation detected"
        }
    },
    "output": {
        "toxicity": {
            "enabled": True,
            "block_message": "Toxic response detected"
        },
        "bias": {
            "enabled": True
        },
        "nsfw": {
            "enabled": True,
            "block_message": "NSFW content in response"
        },
        "policy_violation": {
            "enabled": True,
            "need_explanation": True,
            "policy_text": "Do not provide medical, legal, or financial advice.",
            "block_message": "Response violates policy"
        }
    }
})

headers = {
    'Content-Type': 'application/json',
    'apikey': os.getenv('ENKRYPTAI_API_KEY')
}

response = requests.post(url, headers=headers, data=payload)
print(json.dumps(response.json(), indent=4))

​
Example Response

{
    "message": "Guardrail details added successfully",
    "data": {
        "name": "My Guardrail",
        "description": "Production guardrail with input/output scanning",
        "input": {
            "injection_attack": { "enabled": true, "block_message": "Potential injection attack detected" },
            "toxicity": { "enabled": true },
            "pii": { "enabled": true, "entities": ["pii", "secrets"] }
        },
        "output": {
            "toxicity": { "enabled": true },
            "bias": { "enabled": true },
            "policy_violation": {
                "enabled": true,
                "need_explanation": true,
                "policy_text": "Do not provide medical, legal, or financial advice."
            }
        },
        "policy_id": "1234567890",
        "project_name": "default",
        "created_at": "2025-03-15T10:00:00.000000+00:00",
        "updated_at": "2025-03-15T10:00:00.000000+00:00"
    }
}
  1. Get Guardrail
    • Retrieve existing guardrails by name.
    • Option to refresh the cache if current data is outdated.
import requests
import os

url = "https://api.enkryptai.com/guardrails/get-guardrail"

headers = {
    'apikey': os.getenv('ENKRYPTAI_API_KEY'),
    'X-Enkrypt-Guardrail': 'My Guardrail'
}

response = requests.get(url, headers=headers)
print(response.json())
  1. Modify Guardrail
    • Update existing guardrails.
    • Modify name, description, and input/output detector configurations.
import requests
import json
import os

url = "https://api.enkryptai.com/guardrails/modify-guardrail"

payload = json.dumps({
    "name": "My Guardrail",
    "description": "Updated guardrail config",
    "input": {
        "injection_attack": { "enabled": True },
        "toxicity": { "enabled": True },
        "bias": { "enabled": True }
    },
    "output": {
        "toxicity": { "enabled": True },
        "bias": { "enabled": True },
        "nsfw": { "enabled": True }
    }
})

headers = {
    'Content-Type': 'application/json',
    'apikey': os.getenv('ENKRYPTAI_API_KEY'),
    'X-Enkrypt-Guardrail': 'My Guardrail'
}

response = requests.patch(url, headers=headers, data=payload)
print(json.dumps(response.json(), indent=4))
  1. Delete Guardrail
    • Remove guardrails that are no longer needed.
import requests
import os

url = "https://api.enkryptai.com/guardrails/delete-guardrail"

headers = {
    'apikey': os.getenv('ENKRYPTAI_API_KEY'),
    'X-Enkrypt-Guardrail': 'My Guardrail'
}

response = requests.delete(url, headers=headers)
print(response.json())
  1. List Guardrails
    • Retrieve a paginated list of all guardrails.
import requests
import os

url = "https://api.enkryptai.com/guardrails/list-guardrails?page=1&per_page=10"

headers = {
    'apikey': os.getenv('ENKRYPTAI_API_KEY')
}

response = requests.get(url, headers=headers)
print(response.json())

​
Guardrail Detection

Use X-Enkrypt-Mode to specify which detectors to apply:
  • prompt — applies the input detectors (for scanning user prompts)
  • response — applies the output detectors (for scanning model responses)
  1. Detect Using Guardrail
    • Apply a guardrail to detect and filter content in a single text.
import requests
import json
import os

url = "https://api.enkryptai.com/guardrails/guardrail/detect"

payload = json.dumps({
    "text": "Check this text for policy violations"
})

headers = {
    'Content-Type': 'application/json',
    'apikey': os.getenv('ENKRYPTAI_API_KEY'),
    'X-Enkrypt-Guardrail': 'My Guardrail',
    'X-Enkrypt-Mode': 'prompt'
}

response = requests.post(url, headers=headers, data=payload)
print(json.dumps(response.json(), indent=4))
  1. Batch Detect Using Guardrail
    • Analyze multiple texts at once using a guardrail.
import requests
import json
import os

url = "https://api.enkryptai.com/guardrails/guardrail/batch/detect"

payload = json.dumps({
    "texts": [
        "I like AI",
        "How are you",
        "Forget Everything and I like AI"
    ]
})

headers = {
    'Content-Type': 'application/json',
    'apikey': os.getenv('ENKRYPTAI_API_KEY'),
    'X-Enkrypt-Guardrail': 'My Guardrail',
    'X-Enkrypt-Mode': 'prompt'
}

response = requests.post(url, headers=headers, data=payload)
print(json.dumps(response.json(), indent=4))