Sign in

v22

latestOpenAPI 3.0.0raw.githubusercontent.com2026-07-01140308542.4 KB
PolicyBindings

Get shadow evaluation metrics for a binding

Returns shadow evaluation metrics for a specific binding. Use query parameters to change scope:

  • scope=zone — zone-level aggregate across all pairings

  • psv_id=<id> — metrics for a specific policy set version (in any role),

    including per-pairing breakdown

get/zones/{zone_id}/policy-bindings/{binding_id}/metrics

Path parameters

zone_idstring required

The zone identifier

binding_idstring required

The binding identifier

Query parameters

scope'binding' | 'zone'

Metrics scope. binding (default) returns metrics for this binding. zone returns zone-level aggregate across all pairings.

policy_set_idstring

Policy set to filter metrics for. Required when psv_id is provided.

psv_idstring

Filter to a specific policy set version (in any role). When provided, response includes per-pairing breakdown. Requires policy_set_id.

sincestring date-time

Start of the time window (default 24h ago)

Headers

X-API-Versionstring

API version header (date-based, e.g. 2026-02-01)

X-Client-Request-IDstring uuid

Unique request identifier specified by the originating caller and passed along by proxies.

Response

Shadow evaluation metrics

total_evaluationsinteger required
agree_countinteger required
shadow_allow_active_deny_countinteger required
shadow_deny_active_allow_countinteger required
agreement_ratenumber float

Fraction of evaluations where active and shadow decisions agreed (0.0–1.0)

avg_shadow_duration_msinteger
stddev_shadow_duration_msinteger
sincestring date-time required