Report authorization denials by surface
Report authorization denials by surface for your organization. Requires permissions grants:read, policies:read and audit:read at your acting organization.
v2 compatibility notes
Counts the decisions recorded for your organization that a permission check blocked, by the surface the dispatch came from. Each row’skey is a recorded dispatch surface. A permission denial with no surface 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 getAuthzSurfaceReport returns the same data and
meta as its body.Authorizations
Query Parameters
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.

