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"
    ],
    "enforce_zdr": true,
    "updated_at": "2025-08-24T16:00:00Z"
  }
}

Update an existing guardrail. Management key required.

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

ignored_providerslist of strings or nullOptional

List of provider IDs to exclude from routing

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

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

500

Internal Server Error