Skip to main content
POST
Create guardrail

Authorizations

Authorization
string
header
required

Bearer token: an organization API key (ak_…) created under Settings → API Keys, or a dashboard user session token. Agent keys (xe_…) are not accepted here. Endpoints marked as user-only in their description reject organization keys with 403.

Headers

X-Request-ID
string | null

Path Parameters

agent_id
string<uuid>
required

Body

application/json
name
string
required
Required string length: 1 - 255
kind
enum<string>
required
Available options:
scope,
custom,
memory_write,
context_summary,
doing_more_than_asked,
off_purpose,
customer_reply,
wrong_instruction,
unfair_decision,
deception
stages
enum<string>[]
required
Minimum array length: 1
Available options:
model_request,
model_response,
tool_call,
tool_result,
memory_write,
context_summary
sub_agent_id
string<uuid> | null
prompt
string | null
Maximum string length: 4000
action
enum<string>
default:block
Available options:
allow,
block,
redact,
escalate
enforcement_mode
enum<string>
default:monitor
Available options:
enforce,
monitor
enabled
boolean
default:true
template_id
string | null
Maximum string length: 64

Response

Successful Response

id
string<uuid>
required
agent_id
string<uuid>
required
org_id
string<uuid>
required
name
string
required
kind
string
required
prompt
string | null
required
stages
string[]
required
action
string
required
enforcement_mode
string
required
enabled
boolean
required
template_id
string | null
required
created_at
string<date-time>
required
updated_at
string<date-time>
required
sub_agent_id
string<uuid> | null