> ## Documentation Index
> Fetch the complete documentation index at: https://docs.userintuition.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Observe a live interview

> Create and revoke a view-only link to a live interview

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"]`:

   ```http theme={null}
   POST /api/public/v1/studies/{study_id}/live-interviews/{call_id}/observer-sessions
   Authorization: Bearer ui_sk_...
   Content-Type: application/json

   {
     "permissions": ["observe"],
     "expires_in_seconds": 900
   }
   ```

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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.