Update Domain Lock

Update domain lock of a restream

curl -X POST "https://api.5centscdn.com/v2/streams/restream/1001/domainlock" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
  "enabled": "N",
  "policy": "N",
  "list": "example.com,docs.example.com",
  "noreferer": "Y",
  "ips": ""
}'

import requests
import json

url = "https://api.5centscdn.com/v2/streams/restream/1001/domainlock"
headers = {
  "Content-Type": "application/json",
  "X-API-Key": "YOUR_API_KEY"
}
data = {
  "enabled": "N",
  "policy": "N",
  "list": "example.com,docs.example.com",
  "noreferer": "Y",
  "ips": ""
}

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

const response = await fetch("https://api.5centscdn.com/v2/streams/restream/1001/domainlock", {
  method: "POST",
  headers: {
  "Content-Type": "application/json",
  "X-API-Key": "YOUR_API_KEY"
},
  body: JSON.stringify({
  "enabled": "N",
  "policy": "N",
  "list": "example.com,docs.example.com",
  "noreferer": "Y",
  "ips": ""
})
});

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

package main

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

func main() {
    data := []byte(`{
  "enabled": "N",
  "policy": "N",
  "list": "example.com,docs.example.com",
  "noreferer": "Y",
  "ips": ""
}`)

    req, err := http.NewRequest("POST", "https://api.5centscdn.com/v2/streams/restream/1001/domainlock", 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/domainlock')
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 = '{
  "enabled": "N",
  "policy": "N",
  "list": "example.com,docs.example.com",
  "noreferer": "Y",
  "ips": ""
}'

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": "h264",
    "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 12:48:17",
    "lastseen_at": "2026-04-30 12:48: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": "5"
    },
    "securetoken": {
      "enabled": "N",
      "policy": "D",
      "keyip": "N",
      "list": "",
      "timeout": 3600,
      "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": [
        ""
      ],
      "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": 3,
      "type": "mixed",
      "enabled": true,
      "isEditable": true,
      "id": 69971,
      "autostop": 0,
      "vprofiles": [
        "12345"
      ],
      "aprofiles": [
        "12345"
      ],
      "filters": [],
      "disabled": "0",
      "count": 1,
      "countRaw": 1,
      "codec": "h264",
      "isRunning": false,
      "profiles": {
        "count": {
          "total": 1,
          "uhd": 1
        }
      }
    },
    "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"
    }
  }
}

POST

/streams/restream/{streamid}/domainlock

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

enabledstring

Enable or disable this feature. Y means enabled, N means disabled.

policystring

Access policy for domain lock. Y means whitelist (allow listed domain), N means blacklist (block listed domain).

liststring

Comma-separated list of allowed or blocked entries.

norefererstring

Block requests with no referrer header. Y means blocked, N means allowed.

ipsstring

Comma-separated IP addresses for access control. Leave empty for none.

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

enabledstring

Enable or disable this feature. Y means enabled, N means disabled.

Example:

N

policystring

Access policy for domain lock. Y means whitelist (allow listed domain), N means blacklist (block listed domain).

Example:

N

liststring

Comma-separated list of allowed or blocked entries.

Example:

example.com,docs.example.com

norefererstring

Block requests with no referrer header. Y means blocked, N means allowed.

Example:

Y

ipsstring

Comma-separated IP addresses for access control. Leave empty for none.

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.

idinteger

Unique numeric identifier.

autostopinteger

Whether the stream auto-stops when no input is received.

vprofilesstring[]

List of video transcoding profile IDs applied to this stream.

aprofilesstring[]

List of audio transcoding profile IDs applied to this stream.

filtersstring[]

List of transcoding filter IDs applied to this stream.

disabledstring

Disabled flag. 0 means active; 1 means disabled.

countinteger

Number of active transcoding profiles.

countRawinteger

Total number of transcoding profiles including inactive.

codecstring

Video codec used for the stream.

isRunningboolean

Whether live transcoding is currently active on this stream.

profilesobject

Transcoding profile count summary.

countobject

Number of active transcoding profiles.

totalinteger

Total number of transcoding profiles.

uhdinteger

Number of UHD (4K) transcoding profiles.

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.

Was this page helpful?