---
title: "Create restream"
method: POST
path: "/streaming/restreams"
tags: ["Restreams"]
---

# Create restream

`POST /streaming/restreams`

## 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
    - `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

## Other responses

- `422` — Possible error messages: **{ "errors": { "stream": [ "must exist" ] } }** A required parameter *`stream_id`* wasn't specified or a stream with such ID hasn't been created. **{ "errors": { "stream": [ "does not belong to the same client " ] } }** A stream with specified ID belongs to another client. **{ "errors": { "uri": [ "can't be blank ", "is invalid " ] } }** A required parameter *uri* wasn't specified or the input is incorrect

---

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