Skip to main content
POST
Creates a short-lived live view session for a single camera. Pass the returned session ID and token to /cameras/live_views/offer to start a WebRTC stream, and to /cameras/live_views/stop to end the session. Camera live view is in beta. To enable it for your workspace, contact Seam support. To check whether a camera supports live view, use device.can_stream_live_video.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
device_id
string<uuid>
required

ID of the camera to view.

duration_seconds
integer
default:600

Number of seconds for which the live view session is valid, up to 600.

Required range: 1 <= x <= 600
include_audio
boolean
default:false

Indicates whether to include the camera's audio.

Response

OK

camera_live_view_session
object
required

Represents a short-lived live view session for a single camera. Use the session ID and token to start a WebRTC stream and to stop the session. See the camera_live_view_session object.