---
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 an 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)
    - `allowedOrigins` string[] — List of allowed origins for CORS playback (<scheme>://<hostname>:<port>, <scheme>://<hostname>)
  - `profiles` Profiles — unresolved $ref
  - `recordingSpec` RecordingSpec — unresolved $ref
  - `userTags` UserTags — unresolved $ref
  - `name` Name — unresolved $ref

## Response `204`

Success

## Other responses

- `default` — Error

## Changes

- **2024-10-17** `0d7e15217608` — 1 info
  - added the new optional request property `name`
- **2024-06-18** `82356f03be94` — 2 info
  - added the new optional request property `recordingSpec`
  - the `profiles` request property default value `{"$ref":"#/components/schemas/stream/properties/profiles/default"}` was added
- **2024-05-20** `0ba4f3eadb4e` — 1 info
  - added the new optional request property `playbackPolicy/allowedOrigins`
- **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

[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/0d7e15217608/schema)