---
title: "Create guardrail rule"
method: POST
path: "/v2/guardrail-rules"
tags: ["Guardrail Rules"]
---

# Create guardrail rule

`POST /v2/guardrail-rules`

Creates a new guardrail rule with expression, guardrails configuration, and timeout settings.

## Request body

- object
  - `description` string
  - `display_name` string, required
  - `enabled` boolean
  - `expression` ExpressionInput
    - `cel` string, required
  - `guardrails` GuardrailRef[], nullable
    - `execute_on` 'input' | 'output' | 'both', required
    - `id` string, required
    - `is_guardrail` boolean
    - `options` object
    - `sample_rate` number, double
  - `project_id` string — Optional project ID. If null/omitted, the entity is global (workspace-wide).
  - `timeout` integer

## Response `201`

Guardrail rule created successfully

- object
  - `_id` string, required
  - `created_at` string, date-time, required
  - `created_by_id` string, required
  - `description` string
  - `display_name` string, required
  - `enabled` boolean, required
  - `expression` Expression
    - `cel` string, required
    - `config` object
  - `guardrails` GuardrailRef[], nullable
    - `execute_on` 'input' | 'output' | 'both', required
    - `id` string, required
    - `is_guardrail` boolean
    - `options` object
    - `sample_rate` number, double
  - `plugins` Plugin[], nullable
    - `OfPIIRedaction` PIIRedactionPlugin, required
      - `entities` string[], nullable
      - `id` string, required
      - `language` string
      - `on_failure` string
      - `threshold` number, double
    - `OfResponseHealing` ResponseHealingPlugin, required
      - `id` 'response_healing', required — Plugin discriminator. Must be `response_healing`.
  - `project_id` string, required
  - `timeout` integer, required
  - `updated_at` string, date-time, required
  - `updated_by_id` string, required

## Other responses

- `400` — Bad request
- `409` — Name conflict

---

[API](https://skmtc.net/orq-ai/apis/orq-ai-api.md) · [All operations](https://skmtc.net/orq-ai/apis/orq-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/orq-ai/orq-ai-api/versions/41c02aedc7c0/schema)