Update a guardrail | OpenRouter

import requests
url = "https://openrouter.ai/api/v1/guardrails/550e8400-e29b-41d4-a716-446655440000"
payload = {
    "name": "Updated Guardrail Name",
    "description": "Updated description",
    "limit_usd": 75,
    "reset_interval": "weekly"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.json())

{
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Updated Guardrail Name",
    "created_at": "2025-08-24T10:30:00Z",
    "description": "Updated description",
    "limit_usd": 75,
    "reset_interval": "weekly",
    "allowed_providers": [
      "openai"
    ],
    "allowed_models": null,
    "enforce_zdr": true,
    "updated_at": "2025-08-24T16:00:00Z"
  }
}

Update an existing guardrail.

Authentication

AuthorizationBearer

API key as bearer token in Authorization header

Path parameters

idstringRequiredformat: "uuid"

The unique identifier of the guardrail to update

Request

This endpoint expects an object.

namestringOptional1-200 characters

New name for the guardrail

descriptionstring or nullOptional<=1000 characters

New description for the guardrail

limit_usddouble or nullOptional>=0

New 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

New 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 updated successfully

dataobject

The updated guardrail

Authentication

Path parameters

Request

Response

Errors