Update a guardrail

PATCH 
/api/v1/guardrails/:guardrail_id

Updates an existing guardrail. A document write that actually changes the policy increments version and archives the new document as a GuardrailVersion; metadata-only edits (name / description / context), and re-writing the document the guardrail already holds, leave the version untouched.

Request

Responses

200

Guardrail updated

400

Bad Request — invalid document or variable reference

401

Unauthorized

403

Forbidden

404

Not found

409

The resource has moved past the version this write read (VERSION_CONFLICT): a stated expected_version or If-Match no longer matches, or a concurrent write took the version first. meta.current_version names the version in force. Nothing is written.

413

REQUEST_REJECTED — the request body is over the size the body parser accepts

429

QUOTA_EXCEEDED — a requests quota on the calling API key or its project is spent for the window; Retry-After says when it reopens

Response Headers

Retry-After

Seconds until the quota window admits a request again

500

Unexpected server error — INTERNAL_ERROR, with the raw message never forwarded