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.