SPEKE v2.0 key request (multi-DRM, CPIX 2.3)

POST

/speke/v2.0/copy-protection/{content_id}

Packager sends a CPIX 2.3 XML document with empty Data elements
and DRMSystem entries for the DRMs it needs. The service returns
the document populated with content keys (or wrapped keys) and
DRM-specific signaling data (PSSH for Widevine, WRMHEADER for
PlayReady, key URI for FairPlay).

Auth: AWS SigV4 (for AWS Elemental compatibility) or X-Speke-Auth
header with API key.

Request

Authorization

API Key

Add parameter in header

X-Speke-Auth

Example:

X-Speke-Auth: ********************

API Key

Add parameter in header

Authorization

Example:

Authorization: ********************

Path Params

Body Params application/xmlRequired

Examples

Responses

🟢200

application/xml

Populated CPIX document.

Bodyapplication/xml

🟠400BadRequest

🟠401Unauthorized

🟠403Forbidden

Request Example

Shell

JavaScript

Java

Swift

curl --location '/speke/v2.0/copy-protection/' \
--header 'X-Speke-Auth: <api-key>' \
--header 'Content-Type: application/xml' \
--data '<?xml version="1.0" encoding="UTF-8"?>
<cpix:CPIX xmlns:cpix="urn:dashif:org:cpix"
           xmlns:pskc="urn:ietf:params:xml:ns:keyprov:pskc">
  <cpix:ContentKeyList>
    <cpix:ContentKey kid="abba271e-8bcf-552b-cdd0-aa1d8b00cb6e"/>
  </cpix:ContentKeyList>
  <cpix:DRMSystemList>
    <cpix:DRMSystem kid="abba271e-8bcf-552b-cdd0-aa1d8b00cb6e"
                    systemId="edef8ba9-79d6-4ace-a3c8-27dcd51d21ed"/>
    <cpix:DRMSystem kid="abba271e-8bcf-552b-cdd0-aa1d8b00cb6e"
                    systemId="9a04f079-9840-4286-ab92-e65be0885f95"/>
    <cpix:DRMSystem kid="abba271e-8bcf-552b-cdd0-aa1d8b00cb6e"
                    systemId="94ce86fb-07ff-4f43-adb8-93d2fa968ca2"/>
  </cpix:DRMSystemList>
</cpix:CPIX>'

Response Example

200 - Example 1

<?xml version="1.0" encoding="UTF-8"?>
<root>string</root>

Modified at 2026-05-16 06:35:55

SessionParticipantsListResponse

SPEKE v1.0 key request (legacy, CPIX 2.0)