Share Links
Share links enable public access to report PDFs without authentication. Anyone with the link can retrieve the PDF — ideal for customers, partners, or external recipients.
Creating a Share Link
Section titled “Creating a Share Link”- Open the report in the designer
- Open the Share Drawer
- Click Create Share Link
- Optionally: add a description, restrict environments, set an expiration date
- Copy the generated link
Properties
Section titled “Properties”| Field | Description |
|---|---|
| Token | Automatically generated, unique access key |
| Description | Optional note (e.g. “For customer XY”) |
| Environments | Restrict access to specific environments. Empty = all environments allowed. |
| Expiration Date | Optional expiration date. After expiration the link becomes invalid. Without a date, the link is valid indefinitely. |
The share link has the following format:
https://{domain}/api/public/share-links/{token}/pdf?param1=value1¶m2=value2Report parameters can be passed as URL query parameters. Parameters not provided fall back to their default values.
Revoking
Section titled “Revoking”Share links can be deleted at any time. After deletion, the link is immediately invalid.
- Open the report in the designer
- Open the Share Drawer
- Click Delete next to the corresponding link
Permissions
Section titled “Permissions”Creating and revoking share links requires write access to the report (folder permission: editor or owner).
Tenant Resolution
Section titled “Tenant Resolution”The tenant is resolved from the request domain — either via subdomain (e.g. acme.presswerk.app) or custom domain. This works automatically without the link needing to contain tenant information.