Skip to main content
POST
/
guardrails
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"
      }
    }
  ],
  "actions": {
    "onFail": "block",
    "message": "Invalid JWT token"
  }
}
'
{
  "id": "<string>",
  "slug": "<string>",
  "version_id": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.portkey.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
x-portkey-api-key
string
header
required

Body

application/json
​
name
string
required

Name of the guardrail

Example:

"Content Safety Check"

​
checks
object[]
required

Array of guardrail checks to apply

Minimum array length: 1
​
actions
object
required

Actions to take when guardrail checks fail or pass

​
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)

Response

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

Last modified on January 28, 2026