Encoding ProfilesCreate a DRM Encoding Profile

Create a DRM Encoding Profile

Including fairplay in key_systems requires this service to already have an active FairPlay certificate uploaded - the request is rejected otherwise.

curl -X POST "https://api.5centscdn.com/v2/drm/profiles/new" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
  "_METHOD": "PUT",
  "name": "Widevine + PlayReady HD/SD",
  "key_mode": "hd_sd",
  "hd_height_threshold": 720,
  "key_systems": [
    "widevine",
    "playready"
  ]
}'
{
  "result": "success",
  "id": 7,
  "serviceid": 10001,
  "name": "Widevine + PlayReady HD/SD",
  "key_mode": "hd_sd",
  "hd_height_threshold": 720,
  "key_systems": [
    "widevine",
    "playready"
  ],
  "protection_scheme": "cbcs",
  "created_at": "2026-09-22 12:10:00",
  "updated_at": "2026-09-22 12:10:00"
}
POST
/drm/profiles/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

Must be set to PUT to trigger DRM Encoding Profile creation.

namestring
Required

Friendly name of the profile.

key_modestring
Required

Key-splitting mode. single uses one key for the whole asset, hd_sd uses one key at/above hd_height_threshold and one below, per_rendition uses a separate key per quality tier (SD/HD/HD2/UHD).

Options: single, hd_sd, per_rendition
hd_height_thresholdinteger

Pixel height threshold used by the hd_sd and per_rendition key modes. Defaults to 720.

key_systemsarray
Required

DRM systems to enable. At least one value is required. fairplay requires an active FairPlay certificate on this service.

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

Must be set to PUT to trigger DRM Encoding Profile creation.

Example:
PUT
namestring
Required

Friendly name of the profile.

Example:
Widevine + PlayReady HD/SD
key_modestring
Required

Key-splitting mode. single uses one key for the whole asset, hd_sd uses one key at/above hd_height_threshold and one below, per_rendition uses a separate key per quality tier (SD/HD/HD2/UHD).

Allowed values:singlehd_sdper_rendition
hd_height_thresholdinteger

Pixel height threshold used by the hd_sd and per_rendition key modes. Defaults to 720.

Example:
720
key_systemsarray
Required

DRM systems to enable. At least one value is required. fairplay requires an active FairPlay certificate on this service.

Example:
["widevine","playready"]

Responses

resultstring

Operation outcome. Returns error on validation failure.

Allowed values:successerror
idinteger

Unique identifier of the newly created DRM Encoding Profile.

serviceidinteger

Service account identifier that owns this profile.

namestring

Friendly name of the profile.

key_modestring

Key-splitting mode.

Allowed values:singlehd_sdper_rendition
hd_height_thresholdinteger

Pixel height threshold used by the hd_sd and per_rendition key modes.

key_systemsstring[]

DRM systems enabled for assets encoded with this profile.

Allowed values:widevineplayreadyfairplaywiseplay
protection_schemestring

Common Encryption protection scheme applied to the content.

Allowed values:cbcs
created_atstring

Profile creation timestamp.

updated_atstring

Profile last-update timestamp.