Report gate denials
Report gate denials for your organization. Requires permissions grants:read, policies:read and audit:read at your acting organization.
v2 compatibility notes
Counts the blocked decisions recorded for your organization by each gate that failed. Each row’skey is a gate id, and count is the number of blocked decisions on which that gate failed (a decision with two failed gates counts once for each). A blocked decision with no failed gate recorded is counted in unknownCount.
Who can read it
Your credential must act within an organization, and its role grants must holdgrants:read,
policies:read and audit:read at that organization when the request runs. A credential with no
acting organization returns 403. The report counts only decisions recorded for exactly your
acting organization with no private fence: other organizations’, personal, platform-wide,
private-chat and client-reported decisions are never counted, and no row names a person.
Parameters
400, as does a repeated one.
Coverage
Reports cover your organization’s recorded decisions; checkcoverage.status before treating
counts as complete.
complete: the whole window was read.partialwith reasonwindow_cap: the window held more decisions thanwindowCap. The cap counts every organization’s decisions in the window, so on a busy deployment narrow the window until coverage is complete.sampledistrue.partialwith reasonresolution_read_budget: the read ran out of evidence resolution reads.sampledistrue.unavailablewith reasonunresolved_attribution: a decision in the window has an unknown audience and might be your organization’s, so the counts are not proof of the window.unavailablewith reasonsource_unavailable: the decisions could not be read;rowsis empty.
coverage.examined and coverage.eligible count only your organization’s decisions.
resolutionRevision names the evidence resolution state the report was read at.
Example
forge_call_operation with operationId getGateDenyReport returns the same data and
meta as its body.Authorizations
Query Parameters
With true, the result adds passTallies: for each gate, how many of the same visible decisions passed and blocked there (total is their sum), most-evaluated gate first. As in the Console's Gates view, a skipped gate counts as neither, a gate's several results in one decision count once, a renamed gate counts under its current id, and an access refusal's recorded permission result is left out. Any other report refuses this parameter with 400.
true, false Response
The report
Reports cover your organization's recorded decisions; check coverage.status before treating counts as complete. The window cap counts every organization's decisions in the window, so on a busy deployment narrow the window until coverage is complete. One report over the window window.since..window.until (epoch milliseconds). Each row's key is a failed gate id (gate_denials), a trust policy id (policies_fired), a recorded dispatch surface (authz_denials_by_surface) or a recorded person id (denials_by_person); unknownCount counts decisions that matched the report but recorded no key. sampled is true when the window cap or the resolution read budget stopped the read. passTallies is present only when getGateDenyReport is asked with includePassTallies=true.

