latestOpenAPI 3.1.02026-08-236994571.1 MB

79928a3d37d3

policy management

Validate Policy

Validate a policy configuration before applying it.

Checks:

  • All referenced guardrails exist in the guardrail registry
  • All non-wildcard team aliases exist in the database
  • All non-wildcard key aliases exist in the database
  • Inheritance chains are valid (no cycles, parents exist)
  • Scope patterns are syntactically valid

Returns:

  • valid: True if the policy configuration is valid (no blocking errors)
  • errors: List of blocking validation errors
  • warnings: List of non-blocking validation warnings

Example request:

{
    "policies": {
        "global-baseline": {
            "guardrails": {
                "add": ["pii_blocker", "phi_blocker"]
            },
            "scope": {
                "teams": ["*"],
                "keys": ["*"],
                "models": ["*"]
            }
        },
        "healthcare-compliance": {
            "inherit": "global-baseline",
            "guardrails": {
                "add": ["hipaa_audit"]
            },
            "scope": {
                "teams": ["healthcare-team"]
            }
        }
    }
}
post/policy/validate

Request body

policiesobject required

Policy configuration to validate. Map of policy names to policy definitions.

Response

Successful Response

validboolean required

True if the policy configuration is valid.