OpenTV ENTera & OpenTV Platform Documentation
25.52_Q4 25.26_Q2 25.12_Q1 24.50_Q4 24.38_Q3 24.26_Q2 23.50_Q4 23.24_Q2 23.12_Q1 22.50_Q4 22.38_Q3 22.24_Q2
25.52_Q4 25.26_Q2 25.12_Q1 24.50_Q4 24.38_Q3 24.26_Q2 23.50_Q4 23.24_Q2 23.12_Q1 22.50_Q4 22.38_Q3 22.24_Q2

Modify a device's DTH subscription

Request

To modify the direct-to-home (DTH) products that a device is subscribed to, send a PUT request to:

http://<host>:<port>/cag/v1/{casInstanceName}/devices/{deviceId}/entitlements

Mandatory fields

  • casInstanceName

  • deviceId

Example

A request with this payload subscribes the specified device to the specified products, replacing any existing subscriptions:

{
  "deviceSpecification": 
  {
    "deviceType": "CardLess"
  },
  "entitlements": [
  {
    "productId": "product4"
  },
  {
    "productId": "product5"
  }
  ]
}


Response

A successful request returns an HTTP 200 status.

An unsuccessful request returns an HTTP 400 status if there was a problem with the request.

Example

{
  "status":"Success",
  "commandCount":1,
  "commandResults":[
    {
      "commandName": "overwriteEntitlements",
      "_id": "92fd6b8d-a8f6-4085-bc85-6926e5628393",
      "responseCode": "1028",
      "responseText":"OK"
    }
  ]
}

See also

For full details of this API, see CAS Gateway (CAG) API Documentation.