Update Guardrail
Replaces an existing guardrail’s configuration by its unique ID. This is a full replace of every client-settable field, not a partial patch. key is never changed by an update, even if name changes.
Authorizations
Path Parameters
The UUID of the guardrail
"dfbaa3c6-1e90-43df-869a-b023896a198c"
Body
Human-readable label. Also used to derive the permanent key used at runtime (lowercased, punctuation replaced with underscores, deduplicated with a numeric suffix on collision).
"Hate Speech Filter"
The rule text the agent's LLM evaluates a user's message against to decide whether this guardrail applies.
"Trigger when the user uses hateful, discriminatory, or abusive language toward a person or group."
Free-text tag for grouping guardrails. No fixed list - any string is accepted, including an empty one.
"Content Safety"
Spoken to the user verbatim when this guardrail fires. If omitted, the guardrail falls back to a moderation-endpoint check instead of a canned response.
"I'm sorry, but I can't help with that. Let's keep things respectful."
Where a guardrail_triggered event is POSTed when this guardrail fires. Must be a well-formed http(s):// URL if present. Delivery is fire-and-forget - no retries.
"https://yourapp.com/webhooks/guardrail"
Set to false to exclude this guardrail from live conversations without deleting it.