v32

latestOpenAPI 3.1.0raw.githubusercontent.com2026-05-151,1412,2144.5 MB
Restreams

Create restream

Creates a new restream for a specified live stream.

Specify the target platform's URI (RTMP, RTMPS, or SRT) and the ID of the source stream.

Restreaming allows you to broadcast a single live stream to multiple platforms or servers simultaneously (e.g., Facebook, YouTube, or a custom media server).

How it works:

  1. Get credentials (stream URL/key or SRT URL) from the target platform.
  2. Create a restream in the Gcore system by specifying the target URI and the source live stream.
  3. Start your live stream; it will be automatically pushed to the target destination.
                +-----------------------+
RTMP/RTMPS      |                       | -------->  Facebook (RTMP)
    or  ------> |    Gcore Streaming    | -------->  YouTube (RTMPS)
SRT             |                       | -------->  Media server (SRT)
                +-----------------------+ -------->  Other RTMP/SRT targets

Supported combinations: RTMP → RTMP, RTMPS → RTMPS, RTMP → SRT, SRT → SRT, SRT → RTMP. For SRT targets, only mode=caller is supported (Gcore initiates a PUSH connection).

Source stream parameters (bitrate, codecs, resolution) are sent "as is". Ensure they match the destination requirements.

post/streaming/restreams

Request body

Example request

{
  "restream": {
    "name": "first restream",
    "active": true,
    "uri": "rtmp://a.rtmp.youtube.com/live/k17a-13s8",
    "stream_id": 20,
    "client_user_id": 10
  }
}

Response

Successful