Setting/updating the rating threshold

Request

To set or change the rating threshold(s) for the account (that is, the parental rating for which users will be prompted for the parental PIN), send a PUT request to:

CODE

https://<host>:<port>/adm/v1/user/accounts/parentalControl/actions/updateRatingsThresholds

Headers

x-correlation-id – identifier for logging, to correlate messages across a call flow
nv-tenant-id – the tenant ID
token – request authentication token

Mandatory arguments

If you do not supply a value for a parameter that already has a value, it will be set to null.

So the recommended approach is to use a GET https://adm/v1/user/accounts/parentalControl/ratingsThresholds request to get the currently set threshold(s), make the additions/changes you need to make, then use this modified set of parameters in the body of the PUT request.

The body consists of one or more key/value pairs, where :

The key is the name of the ratings body.
The value

Include a key/value pair for each applicable ratings body.

Other arguments

None

Example

A POST request with this payload sets/updates the ratings threshold for the specified ratings bodies:

CODE

{
  "FSK": "fsk12",
  "TVPG": "TV-MA"
}

Response

A successful request returns an HTTP 200 status.

A bad request returns an HTTP 400 status.

An unauthorised request returns an HTTP 401 status.

A forbidden request returns an HTTP 403 status.

If the account ID or tenant ID found in the token does not exist, the request returns an HTTP 404 status.