Update Domain Lock

Update the domainlock of a publish stream

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

import requests
import json

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

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

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

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

package main

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

func main() {
    data := []byte(`{
  "enabled": "N",
  "list": "www.domain-two.com",
  "ips": "192.168.0.1",
  "policy": "Y",
  "noreferer": "Y"
}`)

    req, err := http.NewRequest("POST", "https://api.5centscdn.com/v2/streams/push/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/push/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",
  "list": "www.domain-two.com",
  "ips": "192.168.0.1",
  "policy": "Y",
  "noreferer": "Y"
}'

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

{
  "result": "success",
  "message": "Stream Created",
  "stream": {
    "monitoring_id": null,
    "type": "push",
    "id": "monitor-12345",
    "serviceid": 103,
    "name": "sample/stream",
    "codec": "h264",
    "ingests": [
      [],
      null
    ],
    "protocols": [
      [
        "HLS"
      ],
      [
        "HLS"
      ]
    ],
    "parentid": null,
    "server": "201",
    "backup": "",
    "dedicatedLTC": "0",
    "hasAdvancedFeatures": "0",
    "monitoring_triggers": null,
    "draft": "0",
    "disabled": "0",
    "created_at": "2026-04-30 07:12:35",
    "updated_at": "2026-04-30 07:12:35",
    "lastseen_at": false,
    "deleted": null,
    "ingestsLock": 0,
    "protocolsLock": 1,
    "status": "Deploying",
    "has": {
      "rtmp": 0,
      "rtsp": 0,
      "hls": 1,
      "dash": 0,
      "rtmpauth": false
    },
    "fms": {
      "server": {
        "country": "North America",
        "meta": {
          "fmsUrl": "rtmp://fms-01-01.5centscdn.com"
        }
      }
    },
    "parts": {
      "pp": "test",
      "sn": "stream",
      "full": "samplestream"
    },
    "restream": {},
    "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_dvr.m3u8",
      "dashManifest": "manifest_dvr.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": {
          "baseQ": "?showcv=true&title=sample/stream",
          "base": "https://cdn.example.com/player/hls/skin1//",
          "hls": "https://cdn.example.com/player/hls/skin1//aHR0cHM6Ly9zdHJlYW0uZXhhbXBsZS5jb20vc2FtcGxlL3N0cmVhbS9wbGF5bGlzdC5tM3U4?showcv=true&title=sample/stream",
          "dash": "https://cdn.example.com/player/dash/skin1//aHR0cHM6Ly9zdHJlYW0uZXhhbXBsZS5jb20vc2FtcGxlL3N0cmVhbS9wbGF5bGlzdC5tM3U4?showcv=true&title=sample/stream"
        }
      },
      "tokenized": {
        "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_dvr.m3u8",
        "dashManifest": "manifest_dvr.mpd",
        "hls": "https://hash-hls-live.5centscdn.com",
        "dash": "https://hash-hls-live.5centscdn.com",
        "players": {
          "hostname": "cdn.example.com",
          "flowplayer": {
            "baseQ": "",
            "base": "https://cdn.example.com/flowplayer/hls/",
            "hls": "https://cdn.example.com/flowplayer/hls/aHR0cHM6Ly9zdHJlYW0uZXhhbXBsZS5jb20vc2FtcGxlL3N0cmVhbS9wbGF5bGlzdC5tM3U4",
            "dash": "https://cdn.example.com/flowplayer/dash/aHR0cHM6Ly9zdHJlYW0uZXhhbXBsZS5jb20vc2FtcGxlL3N0cmVhbS9wbGF5bGlzdC5tM3U4"
          },
          "videojs": {
            "baseQ": "",
            "base": "https://cdn.example.com/videojs/hls/",
            "hls": "https://cdn.example.com/videojs/hls/aHR0cHM6Ly9zdHJlYW0uZXhhbXBsZS5jb20vc2FtcGxlL3N0cmVhbS9wbGF5bGlzdC5tM3U4",
            "dash": "https://cdn.example.com/videojs/dash/aHR0cHM6Ly9zdHJlYW0uZXhhbXBsZS5jb20vc2FtcGxlL3N0cmVhbS9wbGF5bGlzdC5tM3U4"
          },
          "own": {
            "baseQ": "?showcv=true&title=sample/stream",
            "base": "https://cdn.example.com/player/hls/skin1//",
            "hls": "https://cdn.example.com/player/hls/skin1//aHR0cHM6Ly9zdHJlYW0uZXhhbXBsZS5jb20vc2FtcGxlL3N0cmVhbS9wbGF5bGlzdC5tM3U4?showcv=true&title=sample/stream",
            "dash": "https://cdn.example.com/player/dash/skin1//aHR0cHM6Ly9zdHJlYW0uZXhhbXBsZS5jb20vc2FtcGxlL3N0cmVhbS9wbGF5bGlzdC5tM3U4?showcv=true&title=sample/stream"
          }
        },
        "path": {
          "hls": "/test/a4c1f924c3f3377575755f900a6ea602.sdp/playlist_dvr.m3u8",
          "dash": "/test/a4c1f924c3f3377575755f900a6ea602.sdp/manifest_dvr.mpd"
        },
        "token": {
          "hls": "md5=35407AnGQdcg91jyMybBnQ&path=%2Ftest%2Fa4c1f924c3f3377575755f900a6ea602.sdp&expires=1777536769",
          "dash": "md5=35407AnGQdcg91jyMybBnQ&path=%2Ftest%2Fa4c1f924c3f3377575755f900a6ea602.sdp&expires=1777536769"
        }
      }
    },
    "platformsCount": 0,
    "ssl_enabled": true,
    "hash": "a4c1f924c3f3377575755f900a6ea602.sdp",
    "ndvr": {
      "enabled": "Y",
      "retention": "5"
    },
    "securetoken": {
      "enabled": "Y",
      "policy": "D",
      "keyip": "N",
      "list": "32862cdb6276e19a",
      "timeout": 3600,
      "session": "0",
      "ips": "",
      "dirs": null,
      "active": "Y"
    },
    "transcode": {
      "ltc": 0,
      "type": "mixed",
      "enabled": false,
      "isEditable": true
    },
    "domainlock": {
      "enabled": "Y",
      "policy": "Y",
      "list": "example.com,docs.example.com",
      "ips": "",
      "noreferer": "N",
      "active": "Y"
    },
    "geoblock": {
      "enabled": "Y",
      "policy": "Y",
      "list": [
        ""
      ],
      "ips": "",
      "active": "Y"
    },
    "ipaccess": {
      "enabled": "Y",
      "policy": "N",
      "list": "",
      "ips": "",
      "active": "N"
    },
    "useragent": {
      "enabled": "Y",
      "policy": "Y",
      "list": "",
      "ips": "",
      "casesensitive": "N",
      "active": "N",
      "listArr": [
        ""
      ]
    },
    "adInsertion": null,
    "record": {
      "enabled": "Y",
      "retention": "3",
      "stream": {
        "id": 72200,
        "type": "record"
      }
    },
    "rtmpauth": {
      "password": "",
      "active": "N"
    },
    "platforms": [],
    "messages": {}
  },
  "warnings": null,
  "errors": null
}

POST

/streams/push/{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 domain lock. Y means enabled, N means disabled.

liststring

List of domains separated by comma.

ipsstring

List of IPs to whitelist when domain lock is enabled. IPs should be separated by comma.

policystring

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

norefererstring

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

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 domain lock. Y means enabled, N means disabled.

Example:

N

liststring

List of domains separated by comma.

Example:

www.domain-two.com

ipsstring

List of IPs to whitelist when domain lock is enabled. IPs should be separated by comma.

Example:

192.168.0.1

policystring

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

Example:

Y

norefererstring

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

Example:

Y

Responses

resultstring

Status of the API response.

messagestring

Human-readable message describing the result.

streamobject

Stream object containing configuration and status details.

warningsstring

Non-fatal warnings returned with the response.

errorsstring

Errors returned with the response.

Was this page helpful?

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

{ "result": "success", "message": "Stream Created", "stream": { "monitoring_id": null, "type": "push", "id": "monitor-12345", "serviceid": 103, "name": "sample/stream", "codec": "h264", "ingests": [ [], null ], "protocols": [ [ "HLS" ], [ "HLS" ] ], "parentid": null, "server": "201", "backup": "", "dedicatedLTC": "0", "hasAdvancedFeatures": "0", "monitoring_triggers": null, "draft": "0", "disabled": "0", "created_at": "2026-04-30 07:12:35", "updated_at": "2026-04-30 07:12:35", "lastseen_at": false, "deleted": null, "ingestsLock": 0, "protocolsLock": 1, "status": "Deploying", "has": { "rtmp": 0, "rtsp": 0, "hls": 1, "dash": 0, "rtmpauth": false }, "fms": { "server": { "country": "North America", "meta": { "fmsUrl": "rtmp://fms-01-01.5centscdn.com" } } }, "parts": { "pp": "test", "sn": "stream", "full": "samplestream" }, "restream": {}, "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_dvr.m3u8", "dashManifest": "manifest_dvr.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": { "baseQ": "?showcv=true&title=sample/stream", "base": "https://cdn.example.com/player/hls/skin1//", "hls": "https://cdn.example.com/player/hls/skin1//aHR0cHM6Ly9zdHJlYW0uZXhhbXBsZS5jb20vc2FtcGxlL3N0cmVhbS9wbGF5bGlzdC5tM3U4?showcv=true&title=sample/stream", "dash": "https://cdn.example.com/player/dash/skin1//aHR0cHM6Ly9zdHJlYW0uZXhhbXBsZS5jb20vc2FtcGxlL3N0cmVhbS9wbGF5bGlzdC5tM3U4?showcv=true&title=sample/stream" } }, "tokenized": { "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_dvr.m3u8", "dashManifest": "manifest_dvr.mpd", "hls": "https://hash-hls-live.5centscdn.com", "dash": "https://hash-hls-live.5centscdn.com", "players": { "hostname": "cdn.example.com", "flowplayer": { "baseQ": "", "base": "https://cdn.example.com/flowplayer/hls/", "hls": "https://cdn.example.com/flowplayer/hls/aHR0cHM6Ly9zdHJlYW0uZXhhbXBsZS5jb20vc2FtcGxlL3N0cmVhbS9wbGF5bGlzdC5tM3U4", "dash": "https://cdn.example.com/flowplayer/dash/aHR0cHM6Ly9zdHJlYW0uZXhhbXBsZS5jb20vc2FtcGxlL3N0cmVhbS9wbGF5bGlzdC5tM3U4" }, "videojs": { "baseQ": "", "base": "https://cdn.example.com/videojs/hls/", "hls": "https://cdn.example.com/videojs/hls/aHR0cHM6Ly9zdHJlYW0uZXhhbXBsZS5jb20vc2FtcGxlL3N0cmVhbS9wbGF5bGlzdC5tM3U4", "dash": "https://cdn.example.com/videojs/dash/aHR0cHM6Ly9zdHJlYW0uZXhhbXBsZS5jb20vc2FtcGxlL3N0cmVhbS9wbGF5bGlzdC5tM3U4" }, "own": { "baseQ": "?showcv=true&title=sample/stream", "base": "https://cdn.example.com/player/hls/skin1//", "hls": "https://cdn.example.com/player/hls/skin1//aHR0cHM6Ly9zdHJlYW0uZXhhbXBsZS5jb20vc2FtcGxlL3N0cmVhbS9wbGF5bGlzdC5tM3U4?showcv=true&title=sample/stream", "dash": "https://cdn.example.com/player/dash/skin1//aHR0cHM6Ly9zdHJlYW0uZXhhbXBsZS5jb20vc2FtcGxlL3N0cmVhbS9wbGF5bGlzdC5tM3U4?showcv=true&title=sample/stream" } }, "path": { "hls": "/test/a4c1f924c3f3377575755f900a6ea602.sdp/playlist_dvr.m3u8", "dash": "/test/a4c1f924c3f3377575755f900a6ea602.sdp/manifest_dvr.mpd" }, "token": { "hls": "md5=35407AnGQdcg91jyMybBnQ&path=%2Ftest%2Fa4c1f924c3f3377575755f900a6ea602.sdp&expires=1777536769", "dash": "md5=35407AnGQdcg91jyMybBnQ&path=%2Ftest%2Fa4c1f924c3f3377575755f900a6ea602.sdp&expires=1777536769" } } }, "platformsCount": 0, "ssl_enabled": true, "hash": "a4c1f924c3f3377575755f900a6ea602.sdp", "ndvr": { "enabled": "Y", "retention": "5" }, "securetoken": { "enabled": "Y", "policy": "D", "keyip": "N", "list": "32862cdb6276e19a", "timeout": 3600, "session": "0", "ips": "", "dirs": null, "active": "Y" }, "transcode": { "ltc": 0, "type": "mixed", "enabled": false, "isEditable": true }, "domainlock": { "enabled": "Y", "policy": "Y", "list": "example.com,docs.example.com", "ips": "", "noreferer": "N", "active": "Y" }, "geoblock": { "enabled": "Y", "policy": "Y", "list": [ "" ], "ips": "", "active": "Y" }, "ipaccess": { "enabled": "Y", "policy": "N", "list": "", "ips": "", "active": "N" }, "useragent": { "enabled": "Y", "policy": "Y", "list": "", "ips": "", "casesensitive": "N", "active": "N", "listArr": [ "" ] }, "adInsertion": null, "record": { "enabled": "Y", "retention": "3", "stream": { "id": 72200, "type": "record" } }, "rtmpauth": { "password": "", "active": "N" }, "platforms": [], "messages": {} }, "warnings": null, "errors": null }