> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hitheo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 创建护栏策略

> 创建一个新的护栏策略。

创建一个新的护栏策略。此操作具有幂等性——使用相同的 `Idempotency-Key` 请求头会重放相同的响应。

创建策略**不会**自动将其绑定到某个密钥。请使用 [PUT /api/v1/keys/{id}/guardrails](/api-reference/guardrails/key-binding) 为某个密钥启用该策略。

## 身份验证

需要携带具有 `billing` API 密钥作用域的 Bearer 令牌。

## 请求体

<ParamField body="name" type="string" required>
  策略名称。1–128 个字符。不得引用上游供应商名称。
</ParamField>

<ParamField body="description" type="string">
  自由文本描述。最多 512 个字符。
</ParamField>

<ParamField body="rules" type="object[]">
  最多 32 个规则对象。每条规则包含 `guardrail_id`、`phase`、`verdict`，以及可选的 `config` 配置包。
</ParamField>

<ParamField body="scope" type="string">
  `"personal"`（默认）或 `"team"`。团队作用域需要一个活跃的组织以及 `manageWebhooks` 权限。
</ParamField>

<ParamField body="is_default" type="boolean">
  将此策略标记为其所在作用域的默认策略。每个作用域最多只能有一个默认策略。
</ParamField>

## 请求示例

<CodeGroup>
  ```bash curl theme={null}
  curl -X POST https://www.hitheo.ai/api/v1/guardrail-policies \
    -H "Authorization: Bearer $THEO_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "name": "Compliance-strict",
      "description": "PII redaction + jailbreak deny.",
      "rules": [
        { "guardrail_id": "pii_redactor", "phase": "input", "verdict": "redact" },
        { "guardrail_id": "prompt_injection", "phase": "input", "verdict": "deny" }
      ]
    }'
  ```

  ```typescript SDK theme={null}
  const policy = await theo.guardrails.policies.create({
    name: "Compliance-strict",
    description: "PII redaction + jailbreak deny.",
    rules: [
      { guardrail_id: "pii_redactor", phase: "input", verdict: "redact" },
      { guardrail_id: "prompt_injection", phase: "input", verdict: "deny" },
    ],
  });
  ```
</CodeGroup>

## 错误

* `400 guardrail_policy_invalid` — 护栏 id 未知、内置护栏使用了不允许的判定结果、标签中包含供应商名称，或规则数量超出上限。
* `403 missing_scope` — API 密钥缺少 `billing` 作用域。
* `409 conflict` — 该作用域下已存在设置为 `is_default: true` 的策略。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.