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

# Live View

> Get a shareable noVNC URL for interactive live observation of a browser session.

## Overview

Returns a URL that loads an in-browser noVNC client connected to the session's virtual desktop. Useful for:

* Debugging task failures by watching the actual browser in real time.
* Handing control to an end-user for `authenticate` actions in `prompt_user` mode.
* Internal monitoring tools.

The URL is scoped to the session's lifetime and becomes invalid once the session is destroyed.

## Path Parameters

<ParamField path="id" type="string" required={true}>
  Browser session ID (UUID).
</ParamField>

## Example Request

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET "https://api.scrapengine.io/api/v1/browser/sessions/baa3f390-fa6e-4a24-b84a-a575a5f3a9c7/live-view" \
    -H "Authorization: Bearer $SCRAPENGINE_API_KEY"
  ```
</CodeGroup>

## Response

### Success Response (200)

<ResponseField name="url" type="string">
  Shareable live-view URL. Open in any modern browser.
</ResponseField>

**Example Response:**

```json theme={null}
{
  "url": "https://live.scrapengine.io/baa3f390-fa6e-4a24-b84a-a575a5f3a9c7?token=..."
}
```

### Error Responses

| Status | Description                                   |
| ------ | --------------------------------------------- |
| `401`  | Unauthorized — invalid or missing API key.    |
| `404`  | Session not found or not owned by the caller. |