Create a guardrail | OpenRouter

curl -X POST https://openrouter.ai/api/v1/guardrails \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "name": "My New Guardrail",
  "allowed_providers": [
    "openai",
    "anthropic",
    "deepseek"
  ],
  "description": "A guardrail for limiting API usage",
  "enforce_zdr": false,
  "limit_usd": 50,
  "reset_interval": "monthly"
}'

{
  "data": {
    "created_at": "2025-08-24T10:30:00Z",
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "My New Guardrail",
    "allowed_providers": [
      "openai",
      "anthropic",
      "google"
    ],
    "description": "A guardrail for limiting API usage",
    "enforce_zdr": false,
    "limit_usd": 50,
    "reset_interval": "monthly"
  }
}

Create a new guardrail for the authenticated user. Management key required.

Authentication

AuthorizationBearer

API key as bearer token in Authorization header

Request

This endpoint expects an object.

namestringRequired1-200 characters

Name for the new guardrail

allowed_modelslist of strings or nullOptional

Array of model identifiers (slug or canonical_slug accepted)

allowed_providerslist of strings or nullOptional

List of allowed provider IDs

descriptionstring or nullOptional<=1000 characters

Description of the guardrail

enforce_zdrboolean or nullOptional

Whether to enforce zero data retention

ignored_providerslist of strings or nullOptional

List of provider IDs to exclude from routing

limit_usddoubleOptional

Spending limit in USD

reset_intervalenumOptional

Interval at which the limit resets (daily, weekly, monthly)

Allowed values:

Response

Guardrail created successfully

dataobject

Errors

400

Bad Request Error

401

Unauthorized Error

500

Internal Server Error