Skip to main content

​
POST /api/v1/policy-conflicts/analyze

Run static analysis on the tenant’s contact policy configuration to detect conflicts.

​
Response

{
  "conflicts": [
    {
      "type": "contradiction",
      "severity": "high",
      "description": "Policy A blocks email delivery while Policy B requires email as only channel",
      "policies": ["cp_001", "cp_002"],
      "recommendation": "Review channel scoping on both policies"
    },
    {
      "type": "overlap",
      "severity": "medium",
      "description": "Policies C and D both cap email to 3/week with identical scope",
      "policies": ["cp_003", "cp_004"],
      "recommendation": "Consider merging into a single policy"
    },
    {
      "type": "priority_tie",
      "severity": "low",
      "description": "Policies E and F have identical priority (50) and overlapping scope",
      "policies": ["cp_005", "cp_006"],
      "recommendation": "Assign different priorities to ensure deterministic evaluation order"
    }
  ],
  "summary": {
    "totalPolicies": 12,
    "conflictsFound": 3,
    "highSeverity": 1,
    "mediumSeverity": 1,
    "lowSeverity": 1
  }
}

​
Conflict Types

TypeDescription
contradictionTwo policies produce mutually exclusive outcomes
overlapTwo policies cover the same scope with redundant rules
priority_tiePolicies share the same priority and overlapping scope
gapA scope combination has no policy coverage
dead_ruleA policy can never fire due to higher-priority blocking policies
See also: Contact Policies | AI Intelligence