Create a guardrail | OpenRouter

import requests
url = "https://openrouter.ai/api/v1/guardrails"
payload = {
    "name": "My New Guardrail",
    "description": "A guardrail for limiting API usage",
    "limit_usd": 50,
    "reset_interval": "monthly",
    "allowed_providers": ["openai", "anthropic", "deepseek"],
    "allowed_models": None,
    "enforce_zdr": False
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())

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

Create a new guardrail for the authenticated user.

Authentication

AuthorizationBearer

API key as bearer token in Authorization header

Request

This endpoint expects an object.

namestringRequired1-200 characters

Name for the new guardrail

descriptionstring or nullOptional<=1000 characters

Description of the guardrail

limit_usddouble or nullOptional>=0

Spending limit in USD

reset_intervalenum or nullOptional

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

Allowed values:

allowed_providerslist of strings or nullOptional

List of allowed provider IDs

allowed_modelslist of strings or nullOptional

Array of model identifiers (slug or canonical_slug accepted)

enforce_zdrboolean or nullOptional

Whether to enforce zero data retention

Response

Guardrail created successfully

dataobject

The created guardrail

Authentication

Request

Response

Errors