Skip to main content
GET
Report blocked decisions by person for your organization
Counts the blocked decisions recorded for your credential’s acting organization in a window of at most 30 days by the person each was made for. Each row’s key is a person id; a blocked decision with no person recorded counts in unknownCount. No row carries a name, a role grant, who gave it or why. It reads the same population and states coverage the same way as the other organization reports.

Authorizations

Authorization
string
header
required

An External App: the JWT it obtains from POST /oauth/token with OAuth2 client_credentials. Pass as Authorization: Bearer <jwt>. An app's static companion key also authenticates as the app, but is deprecated and is not protected by Idempotency-Key.

Query Parameters

startAt
integer
required

Window start, epoch milliseconds.

Required range: x >= 0
endAt
integer
required

Window end, epoch milliseconds; after startAt and at most 30 days after it.

Required range: x >= 0
windowCap
integer
default:2000

Most decisions read from the window, counted across every organization before your organization's are selected.

Required range: 1 <= x <= 2000

Response

The report

data
object
required

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.

meta
object
required