---
title: "Change restream"
method: PATCH
path: "/streaming/restreams/{restream_id}"
tags: ["Restreams"]
---

# Change restream

`PATCH /streaming/restreams/{restream_id}`

Updates restream settings, such as the target URI or active status

## Path parameters

- `restream_id` integer, required

## Request body

- object
  - `restream` CreateRestream
    - `name` string — Restream name
    - `live` boolean — Indicates that the stream is being published. Has two possible values: - **true** — stream is being published - **false** — stream isn't published
    - `active` boolean — Enables/Disables restream. Has two possible values: - **true** — restream is enabled and can be started - **false** — restream is disabled. Default is true
    - `uri` string — A URL to push the stream to. Supported protocols: rtmp, rtmps, srt. For SRT target URLs, only `mode=caller` is supported.
    - `stream_id` integer — ID of the stream to restream
    - `client_user_id` integer — Custom field where you can specify user ID in your system

## Response `200`

Successful

- Restream
  - `name` string — Restream name
  - `live` boolean — Indicates that the stream is being published. Has two possible values: - **true** — stream is being published - **false** — stream isn't published
  - `active` boolean — Enables/Disables restream. Has two possible values: - **true** — restream is enabled and can be started - **false** — restream is disabled. Default is true
  - `uri` string — A URL to push the stream to. Supported protocols: rtmp, rtmps, srt. For SRT target URLs, only `mode=caller` is supported.
  - `stream_id` integer — ID of the stream to restream
  - `client_user_id` integer — Custom field where you can specify user ID in your system

## Other responses

- `422` — Possible error messages: **{ "errors": { "stream": [ "must exist" ] } }** A stream with such ID was deleted or hasn't been created yet. **{ "errors": { "stream": [ "does not belong to the same client " ] } }** A stream with specified ID belongs to another client. **{ "errors": { "uri": [ "invalid uri, supported protocols are rtmp, rtmps, srt" ] } }** A *uri* parameter input protocol is not supported

---

[API](https://skmtc.dev/g-core/apis/gcore-openapi.md) · [All operations](https://skmtc.dev/g-core/apis/gcore-openapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/g-core/gcore-openapi/revisions/09e652815095/schema)