Export governance decision records
Export the deployment’s governance decision records. Requires permission audit:read at the deployment root.
v2 compatibility notes
Returns one page of resolved governance decisions for the authenticated acting organization in the window, newest first, in one disposition vocabulary (pass, block, hold). Filter by disposition; the legacy allow
and hold-for-approval are read as pass and hold.
The credential must also hold grants:read, policies:read and audit:read at its
acting organization. Current grants are rechecked on each page. Without them the export is
403 permission_denied with a decisionId: the refusal is recorded as an authorization denial, as the
recorded-evidence reads do, and if Forge cannot record it the answer is 503 instead. Unresolved, foreign,
personal, platform and private-channel decisions are excluded, as are client-reported
rows even when includeClientReported=true. Private receipts and proofs are never returned.
An empty page can carry a continuation cursor because authorization follows physical
pagination. Continue until the cursor is null. A page stopped by the reconciliation
budget carries partial: true with saturatedAt: null.
A page reads a bounded number of records, so a large window is paged to its end instead of ending
early. When more records share one millisecond than a page can read, the page carries
partial: true and saturatedAt: the rest of that millisecond is skipped, and cursor
continues below it. A cursor issued before this behavior keeps working. See
Compliance for who can export.
Example
Authorizations
Query Parameters
Response
One page of governance decision records
One page of the deployment's governance decision records, newest first, with one disposition vocabulary (pass, block, hold). Each record is the stored row as written (an open object with a stable id), including principal and person-resource events: the exports are for a deployment-root auditor. Follow cursor until it is null. partial: true with saturatedAt means more records shared that millisecond than one page can read; the rest of that millisecond was skipped, and cursor continues below it.

