Create Guardrail

Creates a new guardrail with specified checks and actions

POST /guardrails

cURL

jwt_authentication

curl --request POST \
  --url https://api.portkey.ai/v1/guardrails \
  --header 'Content-Type: application/json' \
  --header 'x-portkey-api-key: <api-key>' \
  --data '
{
  "name": "JWT Authentication Guard",
  "organisation_id": "550e8400-e29b-41d4-a716-446655440001",
  "checks": [
    {
      "id": "default.jwt",
      "parameters": {
        "jwksUri": "https://example.com/.well-known/jwks.json",
        "headerKey": "Authorization",
        "algorithms": [
          "RS256"
        ],
        "cacheMaxAge": 86400,
        "clockTolerance": 5,
        "maxTokenAge": "1d"
      }
    }
  ]
}
'

200

{
  "id": "<string>",
  "slug": "<string>",
  "version_id": "<string>"
}

---

Portkey is now PRISMA AIRS AI Gateway. See it in action.

Contact Us

Authorizations

x-portkey-api-key · string · header · required

Body

application/json

name · string · required

Name of the guardrail

Example:

"Content Safety Check"

target · enum<string> · default: llm

Target type for the guardrail. Use "llm" for LLM API requests (default) or "mcp_tools" for MCP tool calls.

Available options: llm, mcp_tools

workspace_id · string<uuid>

Workspace UUID (required if organisation_id not provided and not using API key)

organisation_id · string<uuid>

Organisation UUID (required if workspace_id not provided and not using API key)

checks · object[]

Array of guardrail checks to apply. Required for "llm" target; optional for "mcp_tools" target.

Minimum array length: 1

Show child attributes

actions · object

Actions to take when guardrail checks fail or pass. Required for "llm" target; optional for "mcp_tools" target.

Show child attributes

Response

200

application/json

Guardrail created successfully

id · string · required

Unique identifier of the created guardrail

slug · string · required

URL-friendly slug for the guardrail

version_id · string · required

Version identifier for the guardrail configuration