---
title: "Live view url"
method: POST
path: "/boxes/{boxId}/live-view-url"
tags: ["Box"]
---

# Live view url

`POST /boxes/{boxId}/live-view-url`

This endpoint allows you to generate a pre-signed URL for accessing the live view of a running box. The URL is valid for a limited time and can be used to view the box's live stream.

## Path parameters

- `boxId` string, required

## Request body

- LiveView — Live view configuration
  - `expiresIn` string — The live view will be alive for the given duration Supported time units: ms (milliseconds), s (seconds), m (minutes), h (hours) Example formats: "500ms", "30s", "5m", "1h" Default: 180m

## Response `201`

Generate pre-signed live view url

- LiveViewResult — Live view result
  - `url` string, required — Live view url with Gbox interface and basic information, typically used for real-time observation of box usage status
  - `rawUrl` string, required — Raw live view url without additional layout content, typically used for embedding into your own application

---

[API](https://skmtc.net/babelcloud/apis/gbox-open-api.md) · [All operations](https://skmtc.net/babelcloud/apis/gbox-open-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/babelcloud/gbox-open-api/versions/d655577fa915/schema)