---
title: "Patch Guardrails"
method: PATCH
path: "/v2/guardrails/{guardrail_id}"
tags: ["Guardrails"]
---

# Patch Guardrails

`PATCH /v2/guardrails/{guardrail_id}`

Update specific fields of a guardrail using [JSON Patch](https://jsonpatch.com/) operations. Paths must match the **current** document shape - compare against the response from [Get Guardrails](/api-reference/guardrails/get-guardrails) before patching.

## Request body

- object[]
  - `op` 'add' | 'remove' | 'replace' | 'copy' | 'move' | 'test', required
  - `path` string, required — JSON Pointer (RFC 6901) to a field on the guardrail (e.g. `/guardrail_prompt`, `/tags`, `/modality`).
  - `value` string — The value used by the operation. Not required for `remove`.

## Response `200`

Guardrail updated successfully

- object
  - `uuid` string
  - `guardrail_name` string
  - `guardrail_prompt` string
  - `modality` string
  - `callback_url` string
  - `tags` string[]
  - `app_message` boolean — Whether triggering this guardrail emits a real-time app-message event on the conversation.
  - `updated_at` string

## Other responses

- `304` — No changes were made to the guardrail
- `400` — Bad Request
- `401` — UNAUTHORIZED
- `422` — Invalid JSON patch format

---

[API](https://skmtc.dev/tavus/apis/tavus-developer-api-collection.md) · [All operations](https://skmtc.dev/tavus/apis/tavus-developer-api-collection/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tavus/tavus-developer-api-collection/revisions/c878e2f6508d/schema)