Skip to main content

Create & share a public preview link (no login for reviewer)

Recipients open:

/assessments/[assessment-id]/preview/public?token=...

Prerequisites​

  • You can mutate that assessment (canMutateAssessments server checks on preview-token API). Typically builders with edit rights, not passive viewers—if Generate link missing, escalate permissions.
  • Understand prior links are revoked: generating a fresh token rotationally invalidates older active preview tokens for the same assessment (API revokes existing active rows before insert).

Steps​

  1. Open /assessments/[assessment-id] in the authenticated app.
  2. Locate the Public preview affordance launching PublicPreviewModal (exact button label matches UI—often references Share / Public preview).
  3. Click Generate / equivalent—client calls POST /api/v1/assessments/{id}/preview-token.
  4. Wait for previewUrl + expiresAt display (implementation default ≈ 7 days TTL from generation—quote live timestamp shown).
  5. Copy link → send via secure channel; warn recipient not to strip ?token=.
  6. When link must be invalidated early, click Revoke (DELETE flow) inside the modal.

Renewal cadence​

Regenerating is normal after leadership review cycles—remind CX not to resurrect old email threads with stale URLs.

Further reading: Public preview conceptual.