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

# Create a Camera Live View Session

> Creates a short-lived live view session for a single camera. Reference for POST /cameras/live_views/create in the Seam API, with request and response details.

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`.


## OpenAPI

````yaml /openapi.json post /cameras/live_views/create
openapi: 3.0.0
info:
  description: >-
    Programmable API to control locks, thermostats, noise sensors, cameras,
    access control systems, and other IoT devices.


    Prefer the official Seam SDKs over hand-written HTTP calls: they handle

    authentication, request serialization, pagination, and error handling for

    you. The official SDKs are listed in this document under

    `info.x-seam-sdks`.


    If you call the HTTP API directly, your query parameters must be

    serialized compatibly with the Seam API. There is no universal convention

    for serializing arrays, booleans, or nested objects in a query string, so

    use @seamapi/url-search-params-serializer, the language specific serializer
    module provided by each Seam SDK, or follow its specification:

    https://github.com/seamapi/url-search-params-serializer
  title: Seam Connect
  version: 1.0.0
  x-seam-query-serializer:
    description: >-
      Reference implementation and specification for query parameter
      serialization compatible with the Seam API.
    url: https://github.com/seamapi/url-search-params-serializer
  x-seam-sdks:
    - language: javascript
      url: https://github.com/seamapi/javascript
    - language: python
      url: https://github.com/seamapi/python
    - language: ruby
      url: https://github.com/seamapi/ruby
    - language: php
      url: https://github.com/seamapi/php
    - language: csharp
      url: https://github.com/seamapi/csharp
servers:
  - url: https://connect.getseam.com
security: []
tags:
  - description: access_codes
    name: /access_codes
  - description: acs
    name: /acs
  - description: action_attempts
    name: /action_attempts
  - description: client_sessions
    name: /client_sessions
  - description: connected_accounts
    name: /connected_accounts
  - description: connect_webviews
    name: /connect_webviews
  - description: devices
    name: /devices
  - description: events
    name: /events
  - description: health
    name: /health
  - description: locks
    name: /locks
  - description: networks
    name: /networks
  - description: noise_sensors
    name: /noise_sensors
  - description: phones
    name: /phones
  - description: thermostats
    name: /thermostats
  - description: user_identities
    name: /user_identities
  - description: webhooks
    name: /webhooks
  - description: workspaces
    name: /workspaces
paths:
  /cameras/live_views/create:
    post:
      tags: []
      summary: Create a Camera Live View Session
      description: >-
        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`.
      operationId: camerasLiveViewsCreatePost
      requestBody:
        content:
          application/json:
            schema:
              additionalProperties: false
              properties:
                device_id:
                  description: ID of the camera to view.
                  format: uuid
                  type: string
                duration_seconds:
                  default: 600
                  description: >-
                    Number of seconds for which the live view session is valid,
                    up to 600.
                  maximum: 600
                  minimum: 1
                  type: integer
                include_audio:
                  default: false
                  description: Indicates whether to include the camera's audio.
                  type: boolean
              required:
                - device_id
              type: object
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  camera_live_view_session:
                    $ref: '#/components/schemas/camera_live_view_session'
                required:
                  - camera_live_view_session
                type: object
          description: OK
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
      security:
        - client_session: []
components:
  schemas:
    camera_live_view_session:
      description: >-
        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](https://www.seam.co/docs/api/cameras/live_views/object).
      properties:
        camera_live_view_session_id:
          description: ID of the camera live view session.
          format: uuid
          type: string
        device_id:
          description: ID of the camera.
          format: uuid
          type: string
        expires_at:
          description: Date and time at which the live view session expires.
          format: date-time
          type: string
        token:
          description: Token that authorizes the offer and stop requests for this session.
          maxLength: 512
          minLength: 1
          type: string
      required:
        - camera_live_view_session_id
        - device_id
        - token
        - expires_at
      type: object
      x-route-path: /cameras/live_views
  securitySchemes:
    client_session:
      bearerFormat: Client Session Token
      scheme: bearer
      type: http

````