---
title: "Update a live stream"
method: PATCH
path: "/live-streams/{liveStreamId}"
tags: ["Live Streams"]
---

# Update a live stream

`PATCH /live-streams/{liveStreamId}`

Updates the livestream object.

## Path parameters

- `liveStreamId` string, required

## Request body

- LiveStreamUpdatePayload
  - `name` string — The name you want to use for your live stream.
  - `public` boolean — Whether your video can be viewed by everyone, or requires authentication to see it. A setting of false will require a unique token for each view. Learn more about the Private Video feature [here](https://docs.api.video/delivery/video-privacy-access-management).
  - `playerId` string — The unique ID for the player associated with a live stream that you want to update.
  - `restreams` RestreamsRequestObject[] — Use this parameter to add, edit, or remove `RTMPS` or `RTMP` services where you want to restream a live stream. The list can only contain up to 5 destinations. This operation updates all restream destinations in the same request. If you do not want to modify an existing restream destination, you need to include it in your request, otherwise it is removed.
    - `name` string, required — Use this parameter to define a name for the restream destination.
    - `serverUrl` string, required — Use this parameter to set the `RTMPS` or `RTMP` server URL of the restream destination.
    - `streamKey` string, required — Use this parameter to provide the unique key of the live stream that you want to restream.

## Response `200`

Success

- LiveStream
  - `liveStreamId` string, required — The unique identifier for the live stream. Live stream IDs begin with "li."
  - `name` string — The name of your live stream.
  - `streamKey` string — The unique, private stream key that you use to begin streaming.
  - `public` boolean — Whether your video can be viewed by everyone, or requires authentication to see it. A setting of false will require a unique token for each view. Learn more about the Private Video feature [here](https://docs.api.video/delivery/video-privacy-access-management).
  - `assets` LiveStreamAssets
    - `hls` string, uri — The http live streaming (HLS) link for your live video stream.
    - `iframe` string — The embed code for the iframe containing your live video stream.
    - `player` string, uri — A link to the video player that is playing your live stream.
    - `thumbnail` string, uri — A link to the thumbnail for your video.
  - `playerId` string — The unique identifier for the player.
  - `broadcasting` boolean — Whether or not you are broadcasting the live video you recorded for others to see. True means you are broadcasting to viewers, false means you are not.
  - `restreams` RestreamsResponseObject[], required — Returns the list of restream destinations.
    - `name` string — Returns the name of a restream destination.
    - `serverUrl` string — Returns the server URL of a restream destination.
    - `streamKey` string — Returns the unique key of the live stream that is set up for restreaming.
  - `createdAt` string, date-time — When the player was created, presented in ATOM UTC format.
  - `updatedAt` string, date-time — When the player was last updated, presented in ATOM UTC format.

## Other responses

- `400` — Bad Request
- `429` — Too Many Requests

---

[API](https://skmtc.net/apivideo/apis/api-video.md) · [All operations](https://skmtc.net/apivideo/apis/api-video/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/apivideo/api-video/revisions/45ec26f342b6/schema)