---
title: "rooms/:name/live-streaming/update"
method: POST
path: "/rooms/{room_name}/live-streaming/update"
tags: ["rooms"]
---

# rooms/:name/live-streaming/update

`POST /rooms/{room_name}/live-streaming/update`

Update a live stream in a room

## Path parameters

- `room_name` string, required

## Request body

- DailyLiveStreamingOptions
  - `width` number — Property that specifies the output width of the given stream.
  - `height` number — Property that specifies the output height of the given stream.
  - `fps` number — Property that specifies the video frame rate per second.
  - `videoBitrate` number — Property that specifies the video bitrate for the output video in kilobits per second (kbps).
  - `audioBitrate` number — Property that specifies the audio bitrate for the output audio in kilobits per second (kbps).
  - `minIdleTimeOut` number — Amount of time in seconds to wait before ending a recording or live stream when the room is idle (e.g. when all users have muted video and audio). Default: 300 (seconds). Note: Once the timeout has been reached, it typically takes an additional 1-3 minutes for the recording or live stream to be shut down.
  - `maxDuration` number — Maximum duration in seconds after which recording/streaming is forcefully stopped. Default: \`15000\` seconds (3 hours). This is a preventive circuit breaker to prevent billing surprises in case a user starts recording/streaming and leaves the room.
  - `backgroundColor` string — Specifies the background color of the stream, formatted as \#rrggbb or \#aarrggbb string.
  - `instanceId` string — UUID for a streaming or recording session. Used when multiple streaming or recording sessions are running for single room.
  - `type` 'cloud' | 'cloud-audio-only' | 'raw-tracks' — The type of recording that will be started.
  - `layout` union
    - DailyStreamingDefaultLayoutConfig
      - `preset` 'default', required
      - `max_cam_streams` number
    - DailyStreamingSingleParticipantLayoutConfig
      - `preset` 'single-participant', required
      - `session_id` string, required
    - DailyStreamingActiveParticipantLayoutConfig
      - `preset` 'active-participant', required
    - DailyStreamingPortraitLayoutConfig
      - `preset` 'portrait', required
      - `variant` 'vertical' | 'inset'
      - `max_cam_streams` number
    - DailyStreamingCustomLayoutConfig
      - `preset` 'custom', required
      - `composition_id` string, required
      - `composition_params` object
      - `session_assets` object
  - `dataOutputs` string[] — Specifies the types of recording-associated data outputs ("event-json", "transcript-webvtt", "chat-webvtt") to start. Value must be an array listing the requested data outputs.
  - `rtmpUrl` union
    - string
    - string[]
  - `endpoints` DailyStreamingEndpoint[]
    - `endpoint` string, required

## Response `200`

200

## Other responses

- `400` — 400

---

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