alpha.decisions1

Analytics3

Anthropic Messages1

API Keys6

Batch4

Benchmarks1

BYOK5

Chat1

Classifications1

Containers4

Credits2

Datasets3

Embeddings2

Endpoints2

Files5

Generations3

Guardrails13

Images3

Interns10

Models4

OAuth4

Observability5

Organization1

Presets7

Providers1

Rerank1

Responses1

SCIM8

STT1

SystemOne1

TTS1

Vault7

Video Generation4

Workspaces12

Guardrails

Update a guardrail

Update an existing guardrail, or materialize an unconfigured workspace default guardrail. Collection fields use replace semantics: send the full desired set on every update. Management key required.

patch/guardrails/{id}

Path parameters

idstring uuid required

The unique identifier of the guardrail to update

Example:550e8400-e29b-41d4-a716-446655440000

The unique identifier of the guardrail to update

Request body

allowed_data_regionsGuardrailDataRegion[] nullable

Data regions through which requests governed by this guardrail must arrive. global is https://openrouter.ai, europe is https://eu.openrouter.ai, and us is https://us.openrouter.ai. Requests arriving through any other region are rejected. null leaves the ingress region unrestricted. When several guardrails apply (workspace default, member, API key), the effective regions are the intersection of every non-null value. An empty array is rejected.

allowed_modelsstring[] nullable

Array of model identifiers (slug or canonical_slug accepted)

allowed_providersstring[] nullable

New list of allowed provider IDs

descriptionstring nullable

New description for the guardrail

enable_free_model_publicationboolean nullable

Whether this guardrail allows free endpoints that publish prompts.

enable_free_model_trainingboolean nullable

Whether this guardrail allows free endpoints that train on request data.

enable_paid_model_trainingboolean nullable

Whether this guardrail allows paid endpoints that train on request data.

enforce_zdrboolean nullable

Deprecated. Use enforce_zdr_anthropic, enforce_zdr_openai, enforce_zdr_google, enforce_zdr_xai, and enforce_zdr_other instead. When provided, its value is copied into any of those per-provider fields that are not explicitly specified on the request.

enforce_zdr_anthropicboolean nullable

Whether to enforce zero data retention for Anthropic models. Falls back to enforce_zdr when not provided.

enforce_zdr_googleboolean nullable

Whether to enforce zero data retention for Google models. Falls back to enforce_zdr when not provided.

enforce_zdr_openaiboolean nullable

Whether to enforce zero data retention for OpenAI models. Falls back to enforce_zdr when not provided.

enforce_zdr_otherboolean nullable

Whether to enforce zero data retention for models that are not from Anthropic, OpenAI, Google, or xAI. Falls back to enforce_zdr when not provided.

enforce_zdr_xaiboolean nullable

Whether to enforce zero data retention for xAI models. Falls back to enforce_zdr when not provided.

ignored_modelsstring[] nullable

Array of model identifiers to exclude from routing (slug or canonical_slug accepted)

ignored_providersstring[] nullable

List of provider IDs to exclude from routing

include_byok_in_budgetsboolean

Whether BYOK (bring-your-own-key) inference spend counts toward this guardrail's limit_usd, in addition to OpenRouter credit spend. Omit to leave unchanged.

limit_usdnumber double nullable

New spending limit in USD

namestring

New name for the guardrail

reset_interval'daily' | 'weekly' | 'monthly' | 'null' nullable

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

Example request

{
  "description": "Updated description",
  "limit_usd": 75,
  "name": "Updated Guardrail Name",
  "reset_interval": "weekly"
}

Response

Guardrail updated successfully

Example response

{
  "data": {
    "allowed_models": null,
    "allowed_providers": [
      "openai"
    ],
    "content_filter_builtins": [
      {
        "action": "redact",
        "label": "[EMAIL]",
        "slug": "email"
      }
    ],
    "content_filters": null,
    "created_at": "2025-08-24T10:30:00Z",
    "description": "Updated description",
    "enable_free_model_publication": false,
    "enable_free_model_training": true,
    "enable_paid_model_training": true,
    "enforce_zdr": null,
    "enforce_zdr_anthropic": true,
    "enforce_zdr_google": true,
    "enforce_zdr_openai": true,
    "enforce_zdr_other": true,
    "enforce_zdr_xai": true,
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "ignored_models": null,
    "ignored_providers": null,
    "include_byok_in_budgets": true,
    "limit_usd": 75,
    "name": "Updated Guardrail Name",
    "reset_interval": "weekly",
    "updated_at": "2025-08-24T16:00:00Z",
    "workspace_id": "0df9e665-d932-5740-b2c7-b52af166bc11"
  }
}

Changes

Changed in 10 of the 303 revisions of this API.17216

Sep 15, 2026936be9349a631See the full diff
- ○
  added the non-success response with the status
  response-non-success-status-added
Sep 3, 2026bd4953b29f341See the full diff
- ○
  added the non-success response with the status
  response-non-success-status-added
Sep 2, 202629a651ca4ed22See the full diff
- ○
  added the new optional request property
  new-optional-request-property
- ○
  added the optional property ///// to the response with the status
  response-optional-property-added
Aug 26, 2026ed04e14f275511See the full diff
- ●
  added the new secrets enum value to the /////// response property for the response status
  response-property-enum-value-added
- ○
  added the new secrets enum value to the request property //
  request-property-enum-value-added
Aug 7, 20266b6ae78fb2f31See the full diff
- ▲
  the response property ///// became nullable for the status
  response-property-became-nullable
Jul 28, 2026346bdfb17c006See the full diff
- ○
  added the new optional request property
  new-optional-request-property
- ○
  added the new optional request property
  new-optional-request-property
- ○
  added the new optional request property
  new-optional-request-property
- ○
  added the optional property ///// to the response with the status
  response-optional-property-added
- ○
  added the optional property ///// to the response with the status
  response-optional-property-added
- ○
  added the optional property ///// to the response with the status
  response-optional-property-added
Jul 24, 2026e7bfee97794c2See the full diff
- ○
  added the new optional request property
  new-optional-request-property
- ○
  added the required property ///// to the response with the status
  response-required-property-added
Jul 17, 20266aaba48b96d611See the full diff
- ●
  added the new flag enum value to the /////// response property for the response status
  response-property-enum-value-added
- ○
  added the new flag enum value to the request property //
  request-property-enum-value-added
Jul 16, 2026c91cc6f88caa16See the full diff
- ▲
  the request property became not nullable
  request-property-became-not-nullable
- ▲
  the request property became not nullable
  request-property-became-not-nullable
- ▲
  the request property became not nullable
  request-property-became-not-nullable
- ▲
  the request property became not nullable
  request-property-became-not-nullable
- ▲
  the request property // became not nullable
  request-property-became-not-nullable
- ▲
  the request property became not nullable
  request-property-became-not-nullable
- ▲
  the request property became not nullable
  request-property-became-not-nullable
- ▲
  the request property became not nullable
  request-property-became-not-nullable
- ▲
  the request property became not nullable
  request-property-became-not-nullable
- ▲
  the request property became not nullable
  request-property-became-not-nullable
- ▲
  the request property became not nullable
  request-property-became-not-nullable
- ▲
  the request property became not nullable
  request-property-became-not-nullable
- ▲
  the request property became not nullable
  request-property-became-not-nullable
- ▲
  the request property became not nullable
  request-property-became-not-nullable
- ▲
  the request property became not nullable
  request-property-became-not-nullable
- ▲
  the request property became not nullable
  request-property-became-not-nullable
Jul 14, 2026e51e9261ea502See the full diff
- ○
  added the new optional request property
  new-optional-request-property
- ○
  added the optional property ///// to the response with the status
  response-optional-property-added

Full history