Update Pull Stream

Update information of a restream

curl -X POST "https://api.5centscdn.com/v2/streams/restream/1001" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
  "restreamtype": "mediaserver",
  "codec": "h265",
  "server[mediaserver]": "11,211",
  "protocols": [
    "RTSP",
    "HLS"
  ],
  "url[mediaserver][]": "rtmp://fms-01-01.5centscdn.com",
  "mode[mediaserver]": "rtmp",
  "audiofix": "Y",
  "draft": "0",
  "platformtype": ""
}'

import requests
import json

url = "https://api.5centscdn.com/v2/streams/restream/1001"
headers = {
  "Content-Type": "application/json",
  "X-API-Key": "YOUR_API_KEY"
}
data = {
  "restreamtype": "mediaserver",
  "codec": "h265",
  "server[mediaserver]": "11,211",
  "protocols": [
    "RTSP",
    "HLS"
  ],
  "url[mediaserver][]": "rtmp://fms-01-01.5centscdn.com",
  "mode[mediaserver]": "rtmp",
  "audiofix": "Y",
  "draft": "0",
  "platformtype": ""
}

response = requests.post(url, headers=headers, json=data)
print(response.json())

const response = await fetch("https://api.5centscdn.com/v2/streams/restream/1001", {
  method: "POST",
  headers: {
  "Content-Type": "application/json",
  "X-API-Key": "YOUR_API_KEY"
},
  body: JSON.stringify({
  "restreamtype": "mediaserver",
  "codec": "h265",
  "server[mediaserver]": "11,211",
  "protocols": [
    "RTSP",
    "HLS"
  ],
  "url[mediaserver][]": "rtmp://fms-01-01.5centscdn.com",
  "mode[mediaserver]": "rtmp",
  "audiofix": "Y",
  "draft": "0",
  "platformtype": ""
})
});

const data = await response.json();
console.log(data);

package main

import (
    "fmt"
    "net/http"
    "bytes"
    "encoding/json"
)

func main() {
    data := []byte(`{
  "restreamtype": "mediaserver",
  "codec": "h265",
  "server[mediaserver]": "11,211",
  "protocols": [
    "RTSP",
    "HLS"
  ],
  "url[mediaserver][]": "rtmp://fms-01-01.5centscdn.com",
  "mode[mediaserver]": "rtmp",
  "audiofix": "Y",
  "draft": "0",
  "platformtype": ""
}`)

    req, err := http.NewRequest("POST", "https://api.5centscdn.com/v2/streams/restream/1001", bytes.NewBuffer(data))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/json")
    req.Header.Set("X-API-Key", "YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    fmt.Println("Response Status:", resp.Status)
}

require 'net/http'
require 'json'

uri = URI('https://api.5centscdn.com/v2/streams/restream/1001')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request['X-API-Key'] = 'YOUR_API_KEY'
request.body = '{
  "restreamtype": "mediaserver",
  "codec": "h265",
  "server[mediaserver]": "11,211",
  "protocols": [
    "RTSP",
    "HLS"
  ],
  "url[mediaserver][]": "rtmp://fms-01-01.5centscdn.com",
  "mode[mediaserver]": "rtmp",
  "audiofix": "Y",
  "draft": "0",
  "platformtype": ""
}'

response = http.request(request)
puts response.body

{
  "result": "success",
  "message": "Stream Updated",
  "stream": {
    "monitoring_id": null,
    "type": "restream",
    "id": 69971,
    "serviceid": 103,
    "name": "logotest/james",
    "codec": "h265",
    "ingests": [
      [],
      null
    ],
    "protocols": [
      [
        "HLS",
        "RTSP"
      ],
      [
        "HLS",
        "RTSP"
      ]
    ],
    "parentid": null,
    "server": "201",
    "backup": "",
    "dedicatedLTC": "1",
    "hasAdvancedFeatures": "1",
    "monitoring_triggers": null,
    "draft": "0",
    "disabled": "0",
    "created_at": "2026-03-11 13:05:31",
    "updated_at": "2026-04-30 13:29:14",
    "lastseen_at": "2026-04-30 13:29:11",
    "deleted": null,
    "ingestsLock": 0,
    "protocolsLock": 0,
    "status": "Deploying",
    "has": {
      "rtmp": 0,
      "rtsp": 1,
      "hls": 1,
      "dash": 0,
      "rtmpauth": false
    },
    "parts": {
      "pp": "logotest",
      "sn": "james",
      "full": "logotestjames"
    },
    "restream": {
      "type": "mediaserver",
      "mode": "rtmp",
      "urls": [
        "rtmp://fms-01-01.5centscdn.com"
      ],
      "staticip": "N",
      "audiofix": "Y",
      "server": {
        "country": "North America"
      }
    },
    "playbackurls": {
      "scheme": "https",
      "url_prefix": "https://stream-abc12-hls-live.stream.example.com",
      "rtmp": "rtmp://rtmp.5centscdn.com:1935/",
      "rtsp": "rtsp://rtsp.5centscdn.com:554/",
      "hlsManifest": "playlist.m3u8",
      "dashManifest": "manifest.mpd",
      "hls": "https://hash-hls-live.5centscdn.com",
      "dash": "https://hash-hls-live.5centscdn.com",
      "players": {
        "flowplayer": {
          "baseQ": "",
          "base": "https://cdn.example.com/flowplayer/hls/",
          "hls": "https://cdn.example.com/flowplayer/hls/aHR0cHM6Ly9zdHJlYW0uZXhhbXBsZS5jb20vc2FtcGxlL3N0cmVhbS9wbGF5bGlzdC5tM3U4"
        },
        "videojs": {
          "baseQ": "",
          "base": "https://cdn.example.com/videojs/hls/",
          "hls": "https://cdn.example.com/videojs/hls/aHR0cHM6Ly9zdHJlYW0uZXhhbXBsZS5jb20vc2FtcGxlL3N0cmVhbS9wbGF5bGlzdC5tM3U4"
        },
        "own": {
          "hashes": {
            "stream-abc12-hls-live.stream.example.com": {
              "hash": "48nujrim2v7hzm6y",
              "hls": "https://hash-hls-live.5centscdn.com",
              "base64": "aHR0cHM6Ly9zdHJlYW0uZXhhbXBsZS5jb20vc2FtcGxlL3N0cmVhbS9wbGF5bGlzdC5tM3U4",
              "dash": "https://hash-hls-live.5centscdn.com",
              "base64dash": "aHR0cHM6Ly9zdHJlYW0uZXhhbXBsZS5jb20vc2FtcGxlL3N0cmVhbS9wbGF5bGlzdC5tM3U4"
            }
          },
          "baseQ": "?showcv=true&title=logotest/james",
          "base": "https://cdn.example.com/player/hls/skin1/48nujrim2v7hzm6y/",
          "hls": "https://cdn.example.com/player/hls/skin1/48nujrim2v7hzm6y/aHR0cHM6Ly9zdHJlYW0uZXhhbXBsZS5jb20vc2FtcGxlL3N0cmVhbS9wbGF5bGlzdC5tM3U4?showcv=true&title=logotest/james",
          "dash": "https://cdn.example.com/player/dash/skin1/48nujrim2v7hzm6y/aHR0cHM6Ly9zdHJlYW0uZXhhbXBsZS5jb20vc2FtcGxlL3N0cmVhbS9wbGF5bGlzdC5tM3U4?showcv=true&title=logotest/james"
        }
      },
      "tokenized": null
    },
    "platformsCount": 1,
    "ssl_enabled": true,
    "hash": "james.stream",
    "ndvr": {
      "enabled": "N",
      "retention": "18"
    },
    "securetoken": {
      "enabled": "N",
      "policy": "D",
      "keyip": "Y",
      "list": "e4c2c4ed2d921dbe",
      "timeout": 7113,
      "session": "0",
      "ips": "",
      "dirs": null,
      "active": "N"
    },
    "record": null,
    "domainlock": {
      "enabled": "N",
      "policy": "N",
      "list": "example.com,docs.example.com",
      "ips": "",
      "noreferer": "Y",
      "active": "N"
    },
    "geoblock": {
      "enabled": "N",
      "policy": "N",
      "list": [
        "AF"
      ],
      "ips": "",
      "active": "N"
    },
    "ipaccess": {
      "enabled": "N",
      "policy": "N",
      "list": "",
      "ips": "",
      "active": "N"
    },
    "useragent": {
      "enabled": "N",
      "policy": "Y",
      "list": "",
      "ips": "",
      "casesensitive": "N",
      "active": "N",
      "listArr": [
        ""
      ]
    },
    "rtmpauth": {
      "password": "",
      "active": "N"
    },
    "transcode": {
      "ltc": 0,
      "type": "mixed",
      "enabled": false,
      "isEditable": true
    },
    "platforms": [
      {
        "id": 46770,
        "rtmp": "rtmp://live.us.picarto.tv/golive",
        "auth": "N",
        "username": "",
        "password": "",
        "isSRT": false,
        "key": "lll",
        "schedule": "instant",
        "scheduletime": null,
        "codec": null,
        "length": "00:00",
        "relid": 69971,
        "dedicatedLTC": "0",
        "transcode": {
          "ltc": 0,
          "type": "mixed",
          "enabled": false,
          "isEditable": true
        },
        "disabled": "0",
        "name": "h",
        "platform_id": 1,
        "provider_id": 0,
        "video_id": ""
      }
    ],
    "messages": {},
    "adInsertion": {
      "id": 9,
      "relid": 69971,
      "type": "stream",
      "enabled": "Y",
      "policy": "1",
      "provider": "FreeWheel",
      "meta": {
        "adpreroll": {
          "maxDuration": 30,
          "offset": 0
        },
        "adreplacement": {
          "scte35": {
            "adBreakTriggers": [
              "0x22",
              "0x30",
              "0x32",
              "0x34",
              "0x36",
              "splice_insert"
            ],
            "markersToRemove": [
              "ALL"
            ]
          },
          "onStartWithinAdBreak": "replace"
        }
      },
      "defaultDuration": 30,
      "created_at": "2026-04-01 14:04:46",
      "schedules": [],
      "active": "N"
    }
  },
  "warnings": null,
  "errors": null
}

POST

/streams/restream/{streamid}

POST

Base URLstring

Target server for requests. Edit to use your own host.

API Key (header: X-API-Key)

X-API-Keystring

Required

API key (sent in header)

Stream ID

The media type of the request body

Options: application/json

restreamtypestring

The type of restream being used. mediaserver indicates the stream is relayed through a media server.

codecstring

Video codec for the stream. Use h264 or h265.

server[mediaserver]string

The unique identifier for the media server. Examples include 209 for Oceania or 11,211 for North America.

protocolsarray

List of output protocols. Values include HLS, RTMP, DASH, RTSP.

url[mediaserver][]string

A URL pointing to the media server endpoint for accessing the stream.

mode[mediaserver]string

The streaming mode used by the media server. Examples include rtmp, hls, http.

audiofixstring

Fix audio sync issues in pull streams. Y means enabled, N means disabled.

draftstring

Set to 0 to publish the stream, or 1 to save it as a draft.

platformtypestring

Specifies the platform type for the stream. Examples include rtmp or hls.

Request Preview

Response

Response will appear here after sending the request

Authentication

header

X-API-Keystring

Required

API Key for authentication. Provide your API key in the header.

Path Parameters

streamidstring

Required

Stream ID

Example:

1001

Body

application/json

restreamtypestring

The type of restream being used. mediaserver indicates the stream is relayed through a media server.

Example:

mediaserver

codecstring

Video codec for the stream. Use h264 or h265.

Example:

h265

server[mediaserver]string

The unique identifier for the media server. Examples include 209 for Oceania or 11,211 for North America.

Example:

11,211

protocolsarray

List of output protocols. Values include HLS, RTMP, DASH, RTSP.

Example:

["RTSP","HLS"]

url[mediaserver][]string

A URL pointing to the media server endpoint for accessing the stream.

Example:

rtmp://fms-01-01.5centscdn.com

mode[mediaserver]string

The streaming mode used by the media server. Examples include rtmp, hls, http.

Example:

rtmp

audiofixstring

Fix audio sync issues in pull streams. Y means enabled, N means disabled.

Example:

Y

draftstring

Set to 0 to publish the stream, or 1 to save it as a draft.

Example:

0

platformtypestring

Specifies the platform type for the stream. Examples include rtmp or hls.

Example:

Responses

resultstring

Status of the API response.

messagestring

Human-readable message describing the result.

streamobject

Stream object containing configuration and status details.

monitoring_idstring

Unique monitoring identifier for the stream.

typestring

Type identifier for this stream or object.

idinteger

Unique numeric identifier.

serviceidinteger

Unique identifier of the service this stream belongs to.

namestring

Name of the stream.

codecstring

Video codec used for the stream.

ingestsarray[]

List of active ingest connection details for each server.

protocolsarray[]

Supported streaming protocols for each server.

parentidstring

Identifier of the parent stream, if this is a child stream.

serverstring

Server ID or identifier assigned to the stream.

backupstring

Backup server ID for failover.

dedicatedLTCstring

Whether a dedicated live transcoding server is allocated for this stream.

hasAdvancedFeaturesstring

Whether advanced features are enabled for this stream.

monitoring_triggersstring

Monitoring alert trigger configuration for the stream.

draftstring

Draft status flag. 0 means published; 1 means unpublished draft.

disabledstring

Disabled flag. 0 means active; 1 means disabled.

created_atstring

Timestamp when the stream was created.

updated_atstring

Timestamp when the stream was last updated.

lastseen_atstring

Timestamp when the stream was last detected as active.

deletedstring

Deletion timestamp, or null if the stream is not deleted.

ingestsLockinteger

Whether the ingest endpoint list is locked from editing.

protocolsLockinteger

Whether the supported protocol list is locked from editing.

statusstring

Current deployment or operational status of the stream.

hasobject

Flags indicating which streaming protocols are active.

rtmpinteger

Whether RTMP streaming is enabled. 1 = enabled, 0 = disabled.

rtspinteger

Whether RTSP streaming is enabled. 1 = enabled, 0 = disabled.

hlsinteger

Whether HLS streaming is enabled. 1 = enabled, 0 = disabled.

dashinteger

Whether DASH streaming is enabled. 1 = enabled, 0 = disabled.

rtmpauthboolean

Whether RTMP publish authentication is required.

partsobject

Stream name components.

ppstring

Stream name prefix (part 1, before the slash).

snstring

Stream name suffix (part 2, after the slash).

fullstring

Combined full stream name without the slash separator.

restreamobject

Restream platform configuration object.

typestring

Type identifier for this stream or object.

modestring

Operating mode for the configuration.

urlsstring[]

staticipstring

Static IP address associated with this server.

audiofixstring

serverobject

Server ID or identifier assigned to the stream.

countrystring

Geographic region of the ingest server.

playbackurlsobject

Playback URL set for all supported protocols and player types.

schemestring

URL scheme used for playback.

url_prefixstring

Base CDN hostname URL used as a prefix for playback URLs.

rtmpstring

RTMP playback or destination URL.

rtspstring

RTSP playback URL.

hlsManifeststring

HLS manifest filename.

dashManifeststring

DASH manifest filename.

hlsstring

HLS playback or player iframe URL.

dashstring

DASH playback or player iframe URL.

playersobject

Embedded player iframe URL set for supported player types.

flowplayerobject

Flowplayer iframe URL information.

baseQstring

Query string appended to the player iframe URL.

basestring

Base player iframe URL without the stream path.

hlsstring

HLS playback or player iframe URL.

videojsobject

Video.js player iframe URL information.

baseQstring

Query string appended to the player iframe URL.

basestring

Base player iframe URL without the stream path.

hlsstring

HLS playback or player iframe URL.

ownobject

Native stream player iframe URL information.

hashesobject

Map of CDN hostname to stream hashes and playback URLs.

stream-abc12-hls-live.stream.example.comobject

hashstring

Short hash or slug used in stream URLs.

hlsstring

HLS playback or player iframe URL.

base64string

Base64-encoded HLS playback URL for use with iframe players.

dashstring

DASH playback or player iframe URL.

base64dashstring

Base64-encoded DASH playback URL for use with iframe players.

baseQstring

Query string appended to the player iframe URL.

basestring

Base player iframe URL without the stream path.

hlsstring

HLS playback or player iframe URL.

dashstring

DASH playback or player iframe URL.

tokenizedstring

Tokenized playback URL configuration, or null if disabled.

platformsCountinteger

Number of external restreaming platforms configured.

ssl_enabledboolean

Whether HTTPS/SSL is enabled for playback.

hashstring

Short hash or slug used in stream URLs.

ndvrobject

Network DVR (nDVR) rewind configuration for the stream.

enabledstring

Enable or disable this feature.

retentionstring

Retention period in days (record) or minutes (nDVR).

securetokenobject

Secure token URL signing configuration.

enabledstring

Enable or disable this feature.

policystring

Policy mode controlling allow/deny behavior.

keyipstring

Whether the token is bound to the viewer IP address.

liststring

Comma-separated list of allowed or blocked values.

timeoutinteger

Token expiry time in seconds.

sessionstring

Session-based token mode flag.

ipsstring

IP addresses associated with the access control policy.

dirsstring

URL directory paths restricted by this policy.

activestring

Whether this policy is currently enforced.

recordstring

Recording (DVR) configuration for the stream.

domainlockobject

Domain lock (hotlink protection) configuration.

enabledstring

Enable or disable this feature.

policystring

Policy mode controlling allow/deny behavior.

liststring

Comma-separated list of allowed or blocked values.

ipsstring

IP addresses associated with the access control policy.

norefererstring

Whether to allow playback requests with no Referer header.

activestring

Whether this policy is currently enforced.

geoblockobject

Geoblocking access control configuration.

enabledstring

Enable or disable this feature.

policystring

Policy mode controlling allow/deny behavior.

liststring[]

Comma-separated list of allowed or blocked values.

ipsstring

IP addresses associated with the access control policy.

activestring

Whether this policy is currently enforced.

ipaccessobject

IP address access control configuration.

enabledstring

Enable or disable this feature.

policystring

Policy mode controlling allow/deny behavior.

liststring

Comma-separated list of allowed or blocked values.

ipsstring

IP addresses associated with the access control policy.

activestring

Whether this policy is currently enforced.

useragentobject

User-agent based access control configuration.

enabledstring

Enable or disable this feature.

policystring

Policy mode controlling allow/deny behavior.

liststring

Comma-separated list of allowed or blocked values.

ipsstring

IP addresses associated with the access control policy.

casesensitivestring

Whether user-agent pattern matching is case-sensitive.

activestring

Whether this policy is currently enforced.

listArrstring[]

User-agent filter list as a parsed array.

rtmpauthobject

Whether RTMP publish authentication is required.

passwordstring

Password for RTMP publish authentication.

activestring

Whether this policy is currently enforced.

transcodeobject

Live transcoding configuration for the stream.

ltcinteger

Live transcoding server ID assigned to this stream.

typestring

Type identifier for this stream or object.

enabledboolean

Enable or disable this feature.

isEditableboolean

Whether the transcoding configuration can be edited.

platformsarray

List of configured external restreaming platform entries.

idinteger

Unique numeric identifier.

rtmpstring

RTMP playback or destination URL.

authstring

Whether RTMP publish authentication is enabled.

usernamestring

Username for RTMP authentication.

passwordstring

Password for RTMP publish authentication.

isSRTboolean

keystring

RTMP stream key for the restream platform.

schedulestring

Publishing schedule type.

scheduletimestring

codecstring

Video codec used for the stream.

lengthstring

Maximum stream length in hh:mm:ss format.

relidinteger

dedicatedLTCstring

Whether a dedicated live transcoding server is allocated for this stream.

transcodeobject

Live transcoding configuration for the stream.

ltcinteger

Live transcoding server ID assigned to this stream.

typestring

Type identifier for this stream or object.

enabledboolean

Enable or disable this feature.

isEditableboolean

Whether the transcoding configuration can be edited.

disabledstring

Disabled flag. 0 means active; 1 means disabled.

namestring

Name of the stream.

platform_idinteger

provider_idinteger

Unique identifier of the ad insertion provider record.

video_idstring

messagesobject

Informational messages related to the stream state.

adInsertionobject

Ad insertion configuration for the stream, or null if not configured.

idinteger

Unique numeric identifier.

relidinteger

typestring

Type identifier for this stream or object.

enabledstring

Enable or disable this feature.

policystring

Policy mode controlling allow/deny behavior.

providerstring

metaobject

Metadata object for the server.

adprerollobject

Pre-roll ad configuration object.

maxDurationinteger

Maximum duration in seconds.

offsetinteger

adreplacementobject

Ad replacement configuration object.

scte35object

SCTE-35 signalling configuration.

adBreakTriggersstring[]

SCTE-35 splice command types that trigger an ad break.

markersToRemovestring[]

SCTE-35 marker types to strip from the outgoing manifest.

onStartWithinAdBreakstring

Behaviour when a viewer joins during an active ad break.

defaultDurationinteger

created_atstring

Timestamp when the stream was created.

schedulesstring[]

activestring

Whether this policy is currently enforced.

warningsstring

Non-fatal warnings returned with the response.

errorsstring

Errors returned with the response.

Was this page helpful?