Stream ManagementCreate Pull Stream

Create Pull Stream

Create a restream

curl -X POST "https://api.5centscdn.com/v2/streams/restream/new" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
  "_METHOD": "PUT",
  "name": "otilor/dongooo",
  "codec": "h264",
  "protocols": [
    "HLS"
  ],
  "restreamtype": "mediaserver",
  "server[mediaserver]": "11,211",
  "mode[mediaserver]": "hls",
  "url[mediaserver][]": "https://test.co",
  "audiofix": "N",
  "draft": 0,
  "domainlock[enabled]": "Y",
  "domainlock[policy]": "Y",
  "domainlock[list]": "example.com,docs.example.com",
  "domainlock[noreferer]": "N",
  "domainlock[ips]": "",
  "geoblock[enabled]": "Y",
  "geoblock[policy]": "Y",
  "geoblock[list][]": "",
  "geoblock[ips]": "",
  "ipaccess[enabled]": "Y",
  "ipaccess[policy]": "N",
  "ipaccess[list]": "",
  "ipaccess[ips]": "",
  "ndvr[enabled]": "Y",
  "ndvr[retention]": 5,
  "record[server]": 1,
  "record[enabled]": "Y",
  "record[retention]": 3,
  "securetoken[enabled]": "Y",
  "securetoken[policy]": "D",
  "securetoken[list]": "32862cdb6276e19a",
  "securetoken[ips]": "",
  "securetoken[keyip]": "N",
  "securetoken[session]": "0",
  "securetoken[timeout]": 3600,
  "securetoken[active]": "Y",
  "useragent[enabled]": "Y",
  "useragent[policy]": "Y",
  "useragent[list]": "",
  "useragent[casesensitive]": "N",
  "useragent[ips]": "",
  "vprofiles": [
    14931,
    14937
  ],
  "aprofiles": [
    14931
  ],
  "filters": [
    3,
    4
  ]
}'
{
  "result": "success",
  "message": "Stream Created",
  "stream": {
    "monitoring_id": null,
    "type": "restream",
    "id": 72224,
    "serviceid": 103,
    "name": "otilor/dongooo",
    "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 12:07:41",
    "updated_at": "2026-04-30 12:07:41",
    "lastseen_at": false,
    "deleted": null,
    "ingestsLock": 0,
    "protocolsLock": 1,
    "status": "Deploying",
    "has": {
      "rtmp": 0,
      "rtsp": 0,
      "hls": 1,
      "dash": 0,
      "rtmpauth": false
    },
    "parts": {
      "pp": "otilor",
      "sn": "dongooo",
      "full": "otilordongooo"
    },
    "restream": {
      "type": "mediaserver",
      "mode": "hls",
      "urls": [
        "https://test.co"
      ],
      "staticip": "N",
      "audiofix": "N",
      "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_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=otilor/dongooo",
          "base": "https://cdn.example.com/player/hls/skin1//",
          "hls": "https://cdn.example.com/player/hls/skin1//aHR0cHM6Ly9zdHJlYW0uZXhhbXBsZS5jb20vc2FtcGxlL3N0cmVhbS9wbGF5bGlzdC5tM3U4?showcv=true&title=otilor/dongooo",
          "dash": "https://cdn.example.com/player/dash/skin1//aHR0cHM6Ly9zdHJlYW0uZXhhbXBsZS5jb20vc2FtcGxlL3N0cmVhbS9wbGF5bGlzdC5tM3U4?showcv=true&title=otilor/dongooo"
        }
      },
      "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=otilor/dongooo",
            "base": "https://cdn.example.com/player/hls/skin1//",
            "hls": "https://cdn.example.com/player/hls/skin1//aHR0cHM6Ly9zdHJlYW0uZXhhbXBsZS5jb20vc2FtcGxlL3N0cmVhbS9wbGF5bGlzdC5tM3U4?showcv=true&title=otilor/dongooo",
            "dash": "https://cdn.example.com/player/dash/skin1//aHR0cHM6Ly9zdHJlYW0uZXhhbXBsZS5jb20vc2FtcGxlL3N0cmVhbS9wbGF5bGlzdC5tM3U4?showcv=true&title=otilor/dongooo"
          }
        },
        "path": {
          "hls": "/otilor/dongooo.stream/playlist_dvr.m3u8",
          "dash": "/otilor/dongooo.stream/manifest_dvr.mpd"
        },
        "token": {
          "hls": "md5=OhWNamlkGVM10fMHSRFrPw&path=%2Fotilor%2Fdongooo.stream&expires=1777554474",
          "dash": "md5=OhWNamlkGVM10fMHSRFrPw&path=%2Fotilor%2Fdongooo.stream&expires=1777554474"
        }
      }
    },
    "platformsCount": 0,
    "ssl_enabled": true,
    "hash": "dongooo.stream",
    "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": 72225,
        "type": "record"
      }
    },
    "rtmpauth": {
      "password": "",
      "active": "N"
    },
    "platforms": [],
    "messages": {}
  },
  "warnings": null,
  "errors": null
}
POST
/streams/restream/new
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)

Content-Typestring
Required

The media type of the request body

Options: application/json
_METHODstring
Required

HTTP method override for this request. This endpoint accepts POST, but set this to PUT to perform an update operation.

namestring
Required

Friendly name for this resource.

codecstring

Video codec for the stream. Use h264 or h265.

protocolsarray

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

restreamtypestring

The type of restreaming being applied. mediaserver indicates the stream is relayed through a media server.

server[mediaserver]string

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

mode[mediaserver]string

The type of media server mode being used. hls indicates HTTP Live Streaming mode.

url[mediaserver][]string

A URL associated with the media server where the stream can be accessed.

audiofixstring

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

draftinteger

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

domainlock[enabled]string

Whether domain locking is enabled. Y means enabled, N means disabled.

domainlock[policy]string

The domain locking policy. Y means a specific policy applies, N means no policy.

domainlock[list]string

A comma-separated list of allowed domains.

domainlock[noreferer]string

Block requests with no referrer header. Y means blocked (requests with empty referer are blocked); N means allowed.

domainlock[ips]string

A list of IP addresses allowed for domain access.

geoblock[enabled]string

Whether Geo-blocking is enabled. Y means enabled, N means disabled.

geoblock[policy]string

The Geo-blocking policy. Y means a specific policy applies, N means no policy.

geoblock[list][]string

Country codes to block or allow access from. Examples include AF, GB, US.

geoblock[ips]string

A list of IP addresses involved in the geographic access control.

ipaccess[enabled]string

Whether IP access control is enabled. Y means enabled, N means disabled.

ipaccess[policy]string

The IP access policy. Y means a policy applies, N means no specific policy.

ipaccess[list]string

A list of allowed or denied IP addresses.

ipaccess[ips]string

A list of specific IP addresses involved in the access control.

ndvr[enabled]string

Whether NDVR is enabled. Y means enabled, N means disabled.

ndvr[retention]integer

The number of days to retain the NDVR recorded data.

record[server]integer

The DVR server identifier.

record[enabled]string

Whether recording is enabled. Y means enabled, N means disabled.

record[retention]integer

The number of days to keep the recordings.

securetoken[enabled]string

Whether secure token authentication is enabled. Y means enabled, N means disabled.

securetoken[policy]string

The security policy for the tokens.

securetoken[list]string

A token identifier used for access control.

securetoken[ips]string

A list of IP addresses allowed for token access.

securetoken[keyip]string

Whether the token is restricted to a specific IP address. Y means restricted, N means not restricted.

securetoken[session]string

Indicates whether a session is required for token validation. 0 means no session.

securetoken[timeout]integer

The timeout duration in seconds for token validity.

securetoken[active]string

Whether the secure token is currently active. Y means active, N means inactive.

useragent[enabled]string

Whether user-agent access control is enabled. Y means enabled, N means disabled.

useragent[policy]string

The user-agent policy. Y means a policy applies, N means no policy.

useragent[list]string

A list of acceptable or denied user-agent strings.

useragent[casesensitive]string

Whether user-agent matching is case-sensitive. Y means case-sensitive, N means case-insensitive.

useragent[ips]string

A list of IP addresses associated with user-agent control.

vprofilesarray

List of video transcoding profile IDs to apply.

aprofilesarray

List of audio transcoding profile IDs to apply.

filtersarray

List of transcoding filter IDs to apply.

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.

Body

application/json
_METHODstring
Required

HTTP method override for this request. This endpoint accepts POST, but set this to PUT to perform an update operation.

Example:
PUT
namestring
Required

Friendly name for this resource.

Example:
otilor/dongooo
codecstring

Video codec for the stream. Use h264 or h265.

Example:
h264
protocolsarray

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

Example:
["HLS"]
restreamtypestring

The type of restreaming being applied. mediaserver indicates the stream is relayed through a media server.

Example:
mediaserver
server[mediaserver]string

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

Example:
11,211
mode[mediaserver]string

The type of media server mode being used. hls indicates HTTP Live Streaming mode.

Example:
hls
url[mediaserver][]string

A URL associated with the media server where the stream can be accessed.

Example:
https://test.co
audiofixstring

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

Example:
N
draftinteger

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

Example:
0
domainlock[enabled]string

Whether domain locking is enabled. Y means enabled, N means disabled.

Example:
Y
domainlock[policy]string

The domain locking policy. Y means a specific policy applies, N means no policy.

Example:
Y
domainlock[list]string

A comma-separated list of allowed domains.

Example:
example.com,docs.example.com
domainlock[noreferer]string

Block requests with no referrer header. Y means blocked (requests with empty referer are blocked); N means allowed.

Example:
N
domainlock[ips]string

A list of IP addresses allowed for domain access.

Example:
geoblock[enabled]string

Whether Geo-blocking is enabled. Y means enabled, N means disabled.

Example:
Y
geoblock[policy]string

The Geo-blocking policy. Y means a specific policy applies, N means no policy.

Example:
Y
geoblock[list][]string

Country codes to block or allow access from. Examples include AF, GB, US.

Example:
geoblock[ips]string

A list of IP addresses involved in the geographic access control.

Example:
ipaccess[enabled]string

Whether IP access control is enabled. Y means enabled, N means disabled.

Example:
Y
ipaccess[policy]string

The IP access policy. Y means a policy applies, N means no specific policy.

Example:
N
ipaccess[list]string

A list of allowed or denied IP addresses.

Example:
ipaccess[ips]string

A list of specific IP addresses involved in the access control.

Example:
ndvr[enabled]string

Whether NDVR is enabled. Y means enabled, N means disabled.

Example:
Y
ndvr[retention]integer

The number of days to retain the NDVR recorded data.

Example:
5
record[server]integer

The DVR server identifier.

Example:
1
record[enabled]string

Whether recording is enabled. Y means enabled, N means disabled.

Example:
Y
record[retention]integer

The number of days to keep the recordings.

Example:
3
securetoken[enabled]string

Whether secure token authentication is enabled. Y means enabled, N means disabled.

Example:
Y
securetoken[policy]string

The security policy for the tokens.

Example:
D
securetoken[list]string

A token identifier used for access control.

Example:
32862cdb6276e19a
securetoken[ips]string

A list of IP addresses allowed for token access.

Example:
securetoken[keyip]string

Whether the token is restricted to a specific IP address. Y means restricted, N means not restricted.

Example:
N
securetoken[session]string

Indicates whether a session is required for token validation. 0 means no session.

Example:
0
securetoken[timeout]integer

The timeout duration in seconds for token validity.

Example:
3600
securetoken[active]string

Whether the secure token is currently active. Y means active, N means inactive.

Example:
Y
useragent[enabled]string

Whether user-agent access control is enabled. Y means enabled, N means disabled.

Example:
Y
useragent[policy]string

The user-agent policy. Y means a policy applies, N means no policy.

Example:
Y
useragent[list]string

A list of acceptable or denied user-agent strings.

Example:
useragent[casesensitive]string

Whether user-agent matching is case-sensitive. Y means case-sensitive, N means case-insensitive.

Example:
N
useragent[ips]string

A list of IP addresses associated with user-agent control.

Example:
vprofilesarray

List of video transcoding profile IDs to apply.

Example:
[14931,14937]
aprofilesarray

List of audio transcoding profile IDs to apply.

Example:
[14931]
filtersarray

List of transcoding filter IDs to apply.

Example:
[3,4]

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.