Skip to main content
Use a view-only link when someone needs to listen to an active interview without steering or ending it.
  1. List active interviews with GET /api/public/v1/studies/{study_id}/live-interviews and copy the interview’s call_id.
  2. Use a read-scoped API key to create an observer session. Set permissions explicitly to ["observe"]:
  3. Share the returned observer_url only with authorized observers. Anyone with the link can use it until it expires, is revoked, or the interview ends. This example expires after 15 minutes.
Omitting permissions grants observe, steer, and end, even if the API key has only read scope. Pass ["observe"] whenever the recipient should have view-only access. To revoke the link early, use a write-scoped API key to call DELETE /api/public/v1/studies/{study_id}/observer-sessions/{session_id}. Use the session id returned when you created the link.