---
title: "Update a stream"
method: PATCH
path: "/stream/{id}"
tags: ["stream"]
---

# Update a stream

`PATCH /stream/{id}`

## Request body

- StreamPatchPayload
  - `creatorId` union
    - object
      - `type` 'unverified', required
      - `value` string, required
    - string — Helper syntax to specify an unverified creator ID, fully managed by the developer.
  - `record` Record — unresolved $ref
  - `suspended` Suspended — unresolved $ref
  - `multistream` Multistream — unresolved $ref
  - `playbackPolicy` PlaybackPolicy, nullable — Whether the playback policy for a asset or stream is public or signed
    - `type` 'public' | 'jwt' | 'webhook', required
    - `webhookId` string — ID of the webhook to use for playback policy
    - `webhookContext` object — User-defined webhook context
    - `refreshInterval` number — Interval (in seconds) at which the playback policy should be refreshed (default 600 seconds)
  - `profiles` FfmpegProfile[], nullable
    - `width` integer, required
    - `name` string, required
    - `height` integer, required
    - `bitrate` integer, required
    - `fps` integer, required
    - `fpsDen` integer
    - `quality` integer — Restricts the size of the output video using the constant quality feature. Increasing this value will result in a lower quality video. Note that this parameter might not work if the transcoder lacks support for it.
    - `gop` string
    - `profile` 'H264Baseline' | 'H264Main' | 'H264High' | 'H264ConstrainedHigh'
    - `encoder` 'H.264'
  - `userTags` UserTags — unresolved $ref

## Response `204`

Success

## Other responses

- `default` — Error

## Changes

- **2024-05-17** `fc477586b24c` — 1 breaking, 1 info
  - the response property `errors` became optional for the status `default`
  - the request property `playbackPolicy` became nullable
- **2024-05-15** `89f91c9e13d7` — 2 info
  - the request property `profiles` became nullable
  - the `profiles` request property default value `{"name":"240p0","fps":0,"bitrate":250000,"width":426,"height":240}, {"name":"360p0","fps":0,"bitrate":800000,"width":640,"height":360}, {"name":"480p0","fps":0,"bitrate":1600000,"width":854,"height":480}, {"name":"720p0","fps":0,"bitrate":3000000,"width":1280,"height":720}` was removed
- **2024-04-23** `d0909f9b9414` — 1 breaking, 3 info
  - removed `#/components/schemas/creator-id` from the `creatorId` request property `oneOf` list
  - api operation id `updateStream` was added
  - api tag `stream` added
  - added `subschema #1` to the `creatorId` request property `oneOf` list
- **2024-03-29** `b9e5350658ff` — 3 breaking
  - removed the enum value `HEVC` of the request property `profiles/items/encoder`
  - removed the enum value `VP8` of the request property `profiles/items/encoder`
  - removed the enum value `VP9` of the request property `profiles/items/encoder`
- …earlier changes not shown

[Full history](https://skmtc.dev/livepeer/apis/livepeer-api-reference/changes/stream/:id/patch.md)

---

[API](https://skmtc.dev/livepeer/apis/livepeer-api-reference.md) · [All operations](https://skmtc.dev/livepeer/apis/livepeer-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/livepeer/livepeer-api-reference/revisions/fc477586b24c/schema)