Platform Reports provide downloadable snapshots of authorization objects across the PlainID Authorization Platform. Reports are generated through API calls and returned as secure PDF download links.
The reports help organizations review Policy organization, governance, and compliance-related classifications across Environments.
Access and Permissions
Report generation is available at the Environment level.
Supported roles include:
- Environment Viewer and Admin
- Tenant Admin
Permissions are validated both when generating the report and when retrieving the download URL.
Create a Report Request
A POST request creates a Report ID generation request.
When the request is submitted:
- The platform validates the request.
- A unique
reportIdis generated. - The report begins processing.
- Report metadata is returned.
Each request generates a new report ID.
Retrieve the Report Download Link
A GET request uses the reportId to retrieve the latest report metadata and a valid PDF download link.
This flow supports asynchronous report generation. If the report is still processing, the status indicates that generation is still in progress.
Download URLs are time-limited. If a link expires, a new download URL can be generated using the same reportId.
Report Types
Reports are generated as a structured PDF document for operational review, governance analysis, and audit preparation.
-
The
policies_by_attributereport provides an Environment-level overview of Authorization Policies grouped by selected custom Attributes, such as regulatory or compliance classifications.
The report contains:- A high-level distribution summary of Policy classifications.
- Grouped Policy views based on selected Attribute values.
- Policy metadata and associated application information.
- Visibility into Policies that may not yet have assigned classifications.
Report Lifecycle
| Item | Retention |
|---|---|
| Report file | 30 days |
| Download URL validity | 24 hours |
After the download URL expires, a new URL can be retrieved using the report ID.