Publishing and versions
Publishing is what makes a dynamic report available to other people and surfaces it in Insights.
Every report has two sides:
- A draft: your editable working copy. Every update you make changes the draft.
- Published versions: immutable snapshots of the draft.
When you publish, nullplatform takes a snapshot of the current draft and stores it as a new numbered version, starting at 1. The latest snapshot you publish becomes the report's published version, the one other users see.
Publish a report
Send a POST request to the report's /publish endpoint. Nullplatform snapshots the current draft, stores it as a new version, and marks it as the published one:
curl -L -X POST 'https://api.nullplatform.com/report/ff5970bf-592d-4a8d-b858-3175ec444562/publish' \
-H 'Authorization: Bearer <token>'
Work with versions
The rest of the version operations follow the same pattern. Each link takes you to the full reference, with request and response details:
- List published reports: every report that's currently published and visible to you.
- List a report's versions: the published version history. Most useful for finding a version ID to roll back or restore.
- Get the published version: the report's currently published version, with all fields.
- Roll back to a version: makes an earlier version the published one.
- Restore a version into the draft: copies a version's content back into your draft so you can keep editing from it.
Rollback and restore act on opposite sides. Rollback changes what's published (the draft stays as is). Restore changes your draft (what's published stays as is).
Visibility and unpublishing
To change who can see a published report, change its visibility: nullplatform publishes a new version with the current published content and the new visibility, and updates the draft to match.
To take a report out of Insights, unpublish it. The version history is kept, so you can publish or roll back again later.