Overview
Policy violations are records created when a policy matches a target. They show which policy matched, the scope where it matched, the affected target, the effective enforcement mode, and any timing metadata such as SLA due dates.Availability depends on your Cysmiq plan.
Violation statuses
Enforcement
Policy violations carry an effective enforcement mode:
The effective mode may come from the policy itself, a policy binding, a rule-level setting, or an override.
For dependency policies, scan enforcement only includes violations backed by current dependency evidence for that repository and ref.
SLA timing
Policies can define SLA actions with a duration such as7d. Violations created by those policies can include:
- First seen time
- Last seen time
- Due time
- Remaining seconds
- Resolved time
Exceptions
Policy violations can be handled with exceptions:
Exceptions can include a reason and optional expiration date. An exception applies to every active violation with the same policy, scope, and target. Removing it refreshes all matching waived or accepted-risk violations. Violations that were already resolved remain resolved.
Snoozes
When snoozes are enabled, policy violations can be snoozed, approved, rejected, canceled, or cleared through the policy violation workflow. See Snoozes for approval, limits, scope overrides, and user actions.API access
API keys withpolicy-violations:read can list and retrieve policy violations. List filters include repository, ref, status, enforcement mode, policy, target type, limit, and cursor.
See API keys for key scope details.