Update a guardrail | OpenRouter

Update an existing guardrail.

AuthorizationBearer

API key as bearer token in Authorization header

idstringRequiredformat: "uuid"

The unique identifier of the guardrail to update

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

Guardrail updated successfully

dataobject

The updated guardrail

1	curl -X PATCH https://openrouter.ai/api/v1/guardrails/550e8400-e29b-41d4-a716-446655440000 \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"name": "Updated Guardrail Name",
6	"description": "Updated description",
7	"limit_usd": 75,
8	"reset_interval": "weekly"
9	}'

1	{
2	"data": {
3	"id": "550e8400-e29b-41d4-a716-446655440000",
4	"name": "Updated Guardrail Name",
5	"created_at": "2025-08-24T10:30:00Z",
6	"description": "Updated description",
7	"limit_usd": 75,
8	"reset_interval": "weekly",
9	"allowed_providers": [
10	"openai"
11	],
12	"allowed_models": null,
13	"enforce_zdr": true,
14	"updated_at": "2025-08-24T16:00:00Z"
15	}
16	}