Create Guardrail

Create a guardrail policy.

POST/v1/customer/guardrails

Request Parameters

Name	Type	Required	Description
name	string	Required	Guardrail name.
description	string		Optional description.
rules	array	Required	Non-empty rule array.
action	string		Action mode: block \| log \| flag (default block).
is_enabled	boolean		Enable/disable guardrail (default true).

Request Example

bash

curl -X POST https://api.therouter.ai/v1/customer/guardrails
  -H "Authorization: Bearer $THEROUTER_API_KEY"
  -H "Content-Type: application/json"
  -d '{
    "name": "pii-filter",
    "action": "block",
    "is_enabled": true,
    "rules": [{"type": "regex", "pattern": "\b\d{3}-\d{2}-\d{4}\b"}]
  }'

Response

json

{
  "id": "8ad59f90-33d6-4a0f-89a8-d76dba8e2b0f",
  "name": "pii-filter",
  "description": null,
  "rules": [{"type": "regex", "pattern": "\b\d{3}-\d{2}-\d{4}\b"}],
  "action": "block",
  "is_enabled": true,
  "trigger_count": 0,
  "created_at": "2026-02-26T09:00:00.000Z"
}