Delete a guardrail

DELETE 
/api/v1/guardrails/:guardrail_id

Deletes a guardrail and its archived versions by ID.

Request

Responses

204

Deleted

400

Invalid request — a query parameter or body field the operation does not declare, or a value that fails validation

401

Unauthorized

403

Forbidden

404

Not found

409

GUARDRAIL_HAS_REFERENCES — the guardrail is still attached to a tool, agent or project; error.meta lists the references.

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